Historic,  Archive  Document 

i 

Do  not  assume  content  reflects  current 
scientific  knowledge,  policies,  or  practices. 


a325 

iig822 


• 'D,  S>  DEPT.  Of  MRICULlUfiE 

. itenONAL  AGR;CULTi;iAL  LIBMR?; 

MAR  18 1965 

! D & R.PREP. 


LINEAR  PROGRAMMING  AND  RELATED  COMPUTATIONS . 

^ J» 


FARM  PRODUCTION  ECONOMICS  DIVISION/ECONOMIC  RESEARCH  SERVICE/U.S.  DEPARTMENT  OF  AGRICULTURE 


XD>33  BeotqjI«t9 
(!•«}) 


NATIONAL 

A 
G 
R 
I 
C 
U 
L 
T 
U 
R 
A 
L 

LIBRARY  „„ 

ii325 

Ag822 

83925 


Richard  H.  .Day,  Agricultural  Economist,  Farm  Production 
Economics  Division,  Economic  Research  Service,  U.S. 
Department  o'f  Agriculture;  now  Assistant  Professor, 
Department  of  Economics,  University  of  Wisconsin,  Madison 


CONTENTS 


PREFACE 


Page 

xi 


PART  I:  INTRODUCTION 


BACKGROUND 

Significance  of  -Linear  Programming  in  Agricultural 
Economics  Research 

The  Utility  of  Linear  Programming  and  the  Art  of 

Computation 

What  USDA  LP/90  Is - 

The  Purpose  of  This  Handbook- 


1 

1 

2 

2 

3 


A BRIEF  HISTORY  OF  USDA  LP/90 

Predecessors  of  USDA  LP/90 

The  SHARE  LP/90  System 

The  Proprietary  Version 

The  USDA  Version 

Future  Work 

HOW  YOU  CAN  USE  THE  PROGRAM 

The  Various  Possible  Versions  of  LP/90 

How  to  USE  SHARE  LP/90 

How  to  use  PUBLIC  LP/90 

How  to  use  USDA  LP/90 

How  to  use  PROP  LP/90 


PART  II:  A REVIEW  OF  LINEAR  PROGRAMMING  AND  SOME 

RELATED  COMPUTATIONS-- 

THE  PRIMAL  LINEAR  PROGRAMMING  PROBLEM 

Structure 

Example 

Matrix  Representation 

Additional  Remarks  on  the  Primal  Problem 


THE  DUAL  LINEAR  PROGRAMMING  PROBLEM- 

Structure 

Example 

Matrix  Representation 


15 

15 

15 

16 


SOME  THEORETRICAL  PROPERTIES  OF  DUAL  LINEAR  PROGRAMS--- 

Existence  of  Solutions 

Duality  Theorem 

Meaning  of  the  Dual  Variables 

Tight  (Equated)  and  ”Loose^*  (Slack)  Constraints-  — 
Systems  of  Equated  Constraints 


17 

17 

17 

18 
18 
20 


iii 


O0  00  00'vl>vj->j  o^o^o^ 


CONTENTS- -Continued 


Page 

PARAMETRIC  PROGRAMMING - 24 

Parametric  Right-Hand-Side  or  Resource  Mapping  (PL?) 25 

Example 26 

Parametric  Objective  Function  Price  Mapping  (PCR) 34 

Example 35 

Trigger  Analysis  on  Parametric  Constraint  Matrix 44 

SLACK  VARIABLES  AND  BASES--- - - 46 

Slack  Variables  and  Disposal  Activities 46 

Relation  of  Slack  Variables  to  the  '’Loose”  Constraints-  47 

Optimal  Bases  and  Dual  Systems  Equated  Constraints 47 

A Remark  on  the  Simplex  Method 50 

RECURSIVE  LINEAR  PROGRAMMING  (RLP) 51 

The  Basic  Idea 51 

Type  I RLP:  Recursive  RHS,  Diagonal  Primal  Dependence-  52 

Example  of  Type  I RLP:  Process  and  Flexibility 

Adjustment 54 

Type  II  RLP:  Recursive  RHS,  Linear  Primal  Dependence--  57 

Example  of  Type  II  RLP:  Investment  and  Depreciation 58 

Type  III:  Recursive  RHS,  Linear  Dual  Dependence 66 

Example  of  Type  III  RLP:  More  on  Investment  and 

Depreciation 66 

Other  Kinds  of  RLP 71 

PART  III:  THE  DESIGN  AND  USE  OF  LP/90 73 

PHILOSOPHY - - 73 

Need  for  a General  System 73 

The  System  and  Operation  Goncepts 73 

The  Run  Agenda 74 

PREPARING  THE  INPUT  DATA--- — - 77 

The  Job  Concept 77 

Title  or  Remarks  Card 77 

Row  Identification 78 

Basis  Headings 79 

Matrix  Elements 80 

Right-Hand-Side  or  Constraint  Vector  Elements 81 

End  of  Job 82 

Summary  of  Input  (I-Tape)  Data 82 

OPERATING  THE  LP/90  SYSTEM 85 

Machine  Requirements 85 

Tape  Assignments 85 

Normal  Operation 86 

Sense  Switch  Controls 86 

Summary  of  Error  Halts  and  Operator  Response 89 


IV 


CONTENTS “ -C  ont inued 


Page 

OUTPUT  FORMAT - 92 

Operation  Comments  and  the  Run  History 92 

Types  of  Computation  Output 92 

Output  Summary  Line 93 

Full  Print-Out  of  Solution 94 

PART  IV:  SAMPLE  COMPUTATIONS  WITH  USDA  LP/90 96 

INTRODUCTION - 96 

A SINGLE  LP  PROBLEM 97 

Purpose 97 

Data 97 

Agenda 104 

Output 105 

Remarks 111 

MULTIPLE  LP  PROBLEMS - Ill 

Purpose 111 

Data 111 

Agenda * 114 

Output 119 

Remarks 124 

WRITING  REPORTS - - 125 

Purpose 125 

Data 125 

Agenda 126 

How  to  USE  COMPILE - 127 

Output 136 

Remarks 141 

PARAMETRIC  PROGRAMMING — - 142 

Purpose 142 

Data 142 

Agenda 148 

Output 153 

L?  MATRIX  TRANSFORMATION 159 

Purpose 159 

Data 159 

Agenda 183 

Output 184 


V 


CONTENTS- -Continued 


Pa^e 

RECURSIVE  LINEAR  PROGRAJ^jMING 197 

Purpose 197 

Data 198 

Agenda 200 

Output 202 

Remarks 215 

PART  V:  A USER'S  REFERENCE  GUIDE  TO  THE  AGENDUM 

ROUTINES 216 

INTRODUCTION-  — 223 

SHARE  AGENDA - - 224 

PROPRIETARY  AGENDA 256 

USDA  AGENDA 268 

SELECTED  REFERENCES - 273 

LIST  OF  TABLES 

Table  Page 

1.  Definition  of  Variables  and  Objective  Function 

Parameters  for  LP  Illustration-- 10 

2.  Summary  of  Constraints  for  LP  Illustration 11 

3.  Summary  of  Primal  Solutions  for  PLP  Example 30 

4.  Summary  of  Dual  Solutions  for  PLP  Example 30 

5.  Summary  of  Primal  Solutions  for  PCR  Example 40 

6.  Summary  of  Dual  Solutions  for  PCR  Example 40 

7.  Additional  Parameters  for  Type  I RLP  Example 56 

8.  Objective  Function  Coefficients  for  Type  I RLP 

Example 56 

9.  Recursively  Generated  Right  Hand  Sides  for  Type 

I RLP  Example 59 

10.  Primal  Solutions  for  Type  I RLP  Example 59 

11.  PHI  Coefficients  for  Type  II  RLP  Example 61 

12.  RHS  or  Capacity  Coefficients  for  Type  II  RLP 

Example 64 


VI 


LIST  OF  TABLES- -Continued 


Table  Page 

13.  Optimal  Primal  Solutions  for  Type  II  RLP  Example--  64 

14.  Recursive  RHS  Vectors  and  Optimal  Dual  Variables 

for  RLP  Type  III  Example 69 

15.  Optimal  Process  Levels  for  Type  III  RLP  Example 71 

16.  Summary  of  Activities  or  Processes  for  the  Sample 

Model 99 

17.  Summary  of  Constraints  for  Sample  Model--- 99 

18.  L?  Matrix  for  Single  LP 100-101 

19.  Keypunching  From  for  Matrix  Elements 102 

20.  Listing  of  I-Tape  for  Single  LP  Example 103 

21.  0-Tape  Listing  for  Single  LP  Example-- 106-107 

22.  Summary  of  the  Optimal  Solution  of  Single  LP 

Example 110 

23.  LP  Matrix  for  Multiple  LP  Example 112-113 

24.  Agenda  for  Multiple  LP  Example-- 116 

25.  Listing  of  I-Tape  Created  by  Correct. BCD 117-118 

26.  Abridged  0-Tape  Listing  for  Multiple  L?  Example 120-121-122 

27.  Summary  of  the  Four  Optimal  Solutions  (Primal 

Variables  Only) 123 

28.  Compile  Card  Format 130-131 

29.  Print  Spacing  Chart 132 

30.  Report  Coding  Form 133 

31.  Agenda  for  Report  Writing  Example 134-135 

32.  Output  From  Report  Agendum 137-138-139-140 

33.  LP  Matrix  for  Parametric  LP  Example----- 144-145 

34.  I-Tape  Listing  for  Parametric  LP  Example 146 

35.  Agenda  for  Parametric  LP  Example 150-151-152 

36.  Iteration  Summary  Giving  Cotton  Supply  Function---  154 

37.  Iteration  Summary  Giving  Unskilled  Labor  Demand 

Function 154 

38.  Iteration  Summary  Giving  "Flexibility  Response" 

Analysis — 155 

39.  G-Matrix  for  Matrix  Transformation 162-163-164-165 

40.  T-Matrix  for  Matrix  Transformation  Example 166-167-168-169 

170-171-172-173 

174-175-176-177 


vii 


LIST  OF  TABLES- -Continued 


Table  Page 

41.  I-Tape  Listing  for  Matrix  Transformation  Example 178-179-180 

181-182 

42.  H-Matrix  Created  by  Transform 185-186-187 

188-189-190 

43.  Output  From  Picture  Agendum 191-192-193 

44.  New  I-Tape  Listing  H-Matrix  Output  From  A.  to  I. 

Agendum 194-195-196 

45.  Diagonal  Elements  of  T-Matrix  and  Initial  Process 

Levels 199 

46.  Exogenous  RHS-Vectors 199 

47.  Agenda  for  RLP  Example 201 

43.  Output  From  Report  Agendum 203-204-205 

206-207-208 

209-210-211 

LIST  OF  FIGURES 

Number  Page 

1.  Optimal  Value  of  Example  Program  as  a Function  of 

Total  Land  (=  c^  + 8) 31 

2.  Optimal  Process  Levels  of  Example  Program  as 

Functions  of  Total  Land  (=  c^  9)---- 32 

3.  Optimal  Dual  Variables  of  Example  Program  as 

Functions  of  Total  Land  + 9) 33 

4.  Optimal  Value  of  Example  Program  as  a Function 

of  Cotton  Price  (=P2  “ ^5) 

5.  Optimal  Process  Levels  of  Example  Problem  as  Functions 

of  Cotton  Price  (=  ?2  - ^5)-- 42 

6.  Optimal  Dual  Variables  (Marginal  Values)  of  Example 

Program  as  Functions  of  Cotton  Price  (=  P2  - 0) 43 

7.  Type  I RLP  Example:  Progress  of  the  Primal 

Variables  Through  Time 60 

8.  Type  II  RLP  Example:  Progress  of  Primal  Variables 

Through  Time 65 

9.  Type  III  RLP  Example:  Progress  of  Primal  Variables 

Through  time 70 


viii 


LIST  OF  FIGURES--Continued 


Number  Page 

10.  Input  Card  Order 83 

11.  Schematic  Diagram  of  LP  Matrix 84 

12.  Supply  Function  for  Cotton 156 

13.  Demand  Function  for  Labor 157 

14.  Production  of  Cotton  as  Affected  by  Proportional 

Change  in  the  Flexibility  Constraints 158 

15.  Process  Levels  Totalled  by  Crop-- 212 

16.  Marginal  Values  of  the  Constraints 213 

17.  Total  Net  Returns 214 


IX 


',  .4-. 


y'irs  ' ';''..p..' 

' :<;y«w.,''"!ill  'SSiaf  RiS 


.%  *M:"i 


■ /I,  -*'  ' !«5  ^ '*HHV •fis:.*  --^  *'.. aa 

._••  >'  '.\^.'  • . V . - 40v.v'T,f;  Y>l  j?0*tv  • :tA.  (J'v ■*/;■• 

^.f fyti, I i . .-df An  ' 'tk-JiS/t Vv'.  ' ■ 'ib' 

r,  '>■'?'  jT  - ' V ■’  ■ ’’r  ''  ' . , ■ J».  f ^^’  >*■'>  ‘ ■'r^‘-f'  *'**^  ” '.f;  j. 

^ "■"  '•;  ' * ” - - --.  I-,’ 3 ',  ' ■■ 

*'  4 —.a>t  -irfC  i ^ i ^ . ..  .<  '.w*‘ 


'll  t'  f 

' I.  «■ ."  ■ 


*’  ■ •.. 

•■iS 


'• : : ■ f-  - ■•*•;■'«•, .-ii^  , ./ 

■!  . -Jr  • ■ »:  . ''  ‘t.#.  • »«<4!^WMkAi  t * 4 

- • •f-’T*  "r;*  ' «4fc  • . •.  ^ 


.4* 


. - . -j-,fc  . 


“^l' 


-!jl' 


'* ' V<^' 


. i IV. 

*' 

■K^ 

• \ 


V':  ,'.'>■ 


■ V.  r 


.•  ’>.'.  f//t\m*^ 


U*'  ' ' 


<4V^, 


}t’'  "z  1 ■’"■ 


I®  ' V ■'  ':»<?  ".I.  ■ 


!liy 


in  ”11 


•'»  h'  'P,r  t'mt'  >■  ’'■.#•.■■! 

*.>■  tij-.:. 

^ ...  , . ' - v/‘''’*  ■' 

‘ty%:  '’.f*  ,.  1,  Vvj' 

..  • . •**  ‘‘-M  1, 

* » » * ,-' 


*. 


»">4  . 


.X  . •■■  ' ''f/- '* 

,'>A  #,>**>>1^'' 


I -I  » V,  4< 


^ • 

Jf'. 


r -li  ' itr  u 


■4' 


. . •.  ...... /;  .-  >'*S!^  ‘r.'  ■ Ci 


.V.,  ^’'  VTy'''’  >r 


PREFACE 


This  handbook  was  initially  conceived  as  a set  of  examples 
describing --or  rather  illustrating- -the  use  of  a very  pcnizerful  computer 
program  for  linear  programming  and  other  computations.  It  is  still  that, 
but  in  the  viriting  it  has  become  much  more.  First,  it  was  clear  that 
to  understand  the  examples,  it  was  necessary  to  describe  the  general 
character  of  the  computer  program,  or  alternatively,  to  refer  the 
reader  to  an  outside  source.  The  former  seemed  more  convenient  to  the 
student  and  so  Part  III  on  the  Design  and  Use  of  USDA  LP/90  was  in- 
cluded. Second,  a handbook  on  a computer  program  for  linear  programming 
seemed  incomplete  without  at  least  a resume  of  the  theory  of  linear 
programming  itself.  Thus,  it  was  decided  to  present  in  Part  II  such  a 
section.  However,  it  too  grew  beyond  its  initial  bounds  and  became 
rather  an  elementary  introduction  to  linear  programming  and  several 
closely  related  subjects. 

The  result,  then,  is  this  five-part  handbook  including  a general 
Introduction  (Part  I),  An  Introduction  to  Linear  Programming  and  Related 
Computations  (Part  II),  The  Design  and  Use  of  USDA  LP/90  (Part. Ill), 

Sample  Computations  with  USDA  LP/90  (Part  IV)  and  finally,  A Reference 
Guide  to  the  Agendum  Routines  (Part  V) , The  study  as  a x^hole  is  part 
textbook  and  part  reference  manual.  As  such  it  should  be  useful  both 
to  beginneis  and  experts. 

It  is  impossible  to  present  the  main  ideas  of  linear  programming 
(beyond  the  most  superficial  level)  without  the  aid  of  some  mathematics. 
However,  applied  economists  do  not  have  to  prove  the  mathematical  theorems 
of  linear  programming  nor  be  able  to  derive  explicit  solution  techniquea. 

The  mathematicians  have  already  done  the  former  and  the  computer  program 
removes  any  need  for  the  latter.  Yet,  to  use  linear  programming  effectively 
as  an  enq>irical  tool,  the  economist  must  understand  the  logical  meaning 
of  the  theorems,  and  their  economic  significance.  This  can  be  done  by 
studying  examples  rather  than  mathematical  proofs.  This  has  been  the 
approach  taken  here,  though  a certain  amount  of  mathematical  notation 
must  be  used  even  for  this  purpose. 
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Unorthodox  Is  the  omission  of  all  but  the  briefest  comment  on 
the  Simplex  Method.  It  is  the  author’s  opinion  that  for  beginners  time 
spent  on  that  subject  might  much  more  profitably  be  allocated  to  learning 
the  use  of  an  effective  computer  program.  Parts  III,  IV  and  V are 
designed  to  serve  just  such  an  heuristic  purpose.  To  put  the  matter 
bluntly,  understanding  the  theory  of  linear  programming  is  essential 
for  constructing  models  and  interpreting  their  solutions.  Understanding 
the  mathematics  of  computing  solutions  is  not  essential  so  lorig  as  one 
has  a good  computer  program  at  hand  to^kio  the  dirty  v7ork.”  The  Simplex 
Method  and  its  variants  can,  in  short,  be  left  to  the  specialist. 

The  support  of  two  organizations  in  the  preparation  of  this  guide 
needs  particularly  to  be  aclmowledged . The  first  is  the  National  Cotton 
Council  which  supported  the  author  v/ith  a part  time  research  stipend  while 
he  was  on  leave  from  the  U.S.  Department  of  Agriculture  from  November 
1960  to  July  1962.  It  was  during  this  period  that  the  author  explored 
the  use  of  the  LP/90  computer  system  and  developed  specifications  for 
the  special  USDA  features  described  in  the  text.  The  second  organization 
is  CEIR,  Inc.  which  made  the  documentation  of  the  LP/90  system  available 
to  the  author  before  its  public  release.  Inaddition  to  these,  acknowledgment 
is  due  Eli  Hellerman  and  Hugh  Pov/ell  of  CEIR,  Inc.  who  programmed  the 
USDA  features  and  who  served  as  patient  instructors  in  the  art  of  using 
the  LP/90  system,  and  to  Tony  Round  of  the  same  organization  for 
assistance  in  computing  the  examples  in  Part  IV. 

Two  pieces  of  the  present  volume  draw  heavily  on  material  about 
LP/90  previously  published  by  CEIR,  Inc.  They  are  Part  III,  Sections 
3 and  4 and  Part  V,  Sections  1 and  2.  The  Social  Systems  Research 
Institute  of  the  University  of  Wisconsin  provided  secretarial  and 
clerical  help  in  the  preparation  of  the  manuscript.  Finally,  the  author 
should  like  to  ackncn^ledge  the  encouragement  and  help  of  his  many 
colleagues  at  the  U.S.  Department  of  Agriculture,  particularly  Burton  L. 
French  and  W:^  Neill  Schaller. 
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PART  I INTRODUCTION 


1.  BACKGROUND 

a.  The  Significance  of  Linear  Programming  in  Agricultural 
Economics  Research 

/ 

It  is  remarkable  that  linear  programming  (LP)  has  become  one  of 
the  stocks  in  trade  of  agricultural  economists  in  a span  of  time  that 
covers  little  more  than  a decade.  The  first  application  of  linear  pro- 
gramming to  agriculture  per  se  was  described  by  Hildreth  and  Reiter  in 
their  paper  "On  the  Choice  of  a Crop  Rotation  Plan"  [ 7 ] * Since  that 
publication  in  1951  the  literature  of  Agricultural  Economics  has 
contained  LP  contributions  to  many  fields,  from  production  economics 
and  farm  management,  to  marketing  economics  and  spatial  competition. 

That  this  should  have  come  to  pass  is  no  mere  accident.  It  is 
surely  because  linear  programming  approximates  tv/o  essential  features 
of  many  economic  problems,  (1)  Economic  choices  in  practice  are  made 
amorg  a finite  set  of  competing  alternatives,  and  (2)  the  best  choice 
among  available  alternatives  is,  in  practice,  severely  constrained  by 
a variety  of  economic,  technological  and  social  factors, 

While  linear  programming  does  not  make  possible  a satisfactory 
solution  to  all  research  problems,  it  does  make  possible  useful  answers 
to  many  compelling  questions,  and--as  the  art  of  model  building  develops-- 
the  range  of  questions  to  which  it  contributes  continually  widens.  The 
following  list  of  problems  is  only  Indicative: 

(a)  The  least-cost  mix  of  feeds  that  meet  certain  nutritional 
standards  (the  feed-mix  problem), 

(b)  The  best  production  plans  for  farmers  with  different 
tenure  position  given  their  price  eicpectations. 

(c)  The  .optimal  floi7  of  agricultural  commodities  among  various 
economic  regions. 

(d)  Long-run  equilibrium  outputs  in  various  agricultural  areas. 

(e)  The  alternative  effects  of  various  federal  price  supports 
and  production  controls  on  regional  agricultural  production. 


* Numbers  in  brackets  refer  to  Selected  References  on  page  273. 
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bo  The  Utility  of  Linear  Programming  and  the  Art  of  Computation 

While  the  utility  of  linear  programming  for  applied  economics 
depends  on  the  inherent  realism  of  its  logical  structure,  it  depends 
equally  on  technical  breakthroughs  in  computer  science.  Without  the 
latter  the  subject  would  have  been  important  theoretically,  but  of  as 
little  relevance  for  empirical  work  as  many  another  economic  concept. 

As  computer  “hardware**  has  developed,  computer  programs  enabling 
larger  and  larger  models  to  be  solved  have  come  into  being.  At  this 
particular  writing  it  is  possible  in  several  hours  time  to  solve  linear 
programming  models  with  as  many  as  five  thousand  variables  and  a 
thousand  constraints.  It  is  likely  that  models  of  this  size  would 
contain  from  fifty  thousand  to  two  hundred  fifty  thousand  parameters.” 
Because  so  many  variables  interact  in  actual  economic  life,  these 
developments  have  had  everything  to  do  with  the  extensive  application 
of  linear  programming. 

c.  What  USDA  LP/90  Is 

*'USDA  LP/90"  is  the  name  of  one  computer  program  designed  to 
solve  linear  programming  problems  with  up  to  a thousand  constraints  and 
more  than  five  thousand  *'activities**  or  variables. 

Many  other  computer  programs  for  many  different  kinds  of  computers 
are  currently  available  for  solving  linear  programming  problems.  Each 
has  its  own  particular  advantages--there  is  probably  no  one  best  computer 
program.  Which  one  is  to  be  used  in  a particular  case  will  depend  on 
the  problem  size,  the  type  of  computer  available,  etc.  USDA  LP/90  is 
available  to  the  research  workers  employed  by  the  USDA  and  to  its  research 
cooperators  in  Universities  and  State  Experiment  Stations.  Other 
researchers  can  also  arrange  to  use  the  system--or  its  equivalent  (see 
Section  3 below). 

Because  of  the  USDA  LP/90 *s  speed  it  will  usually  be  quite 
economical.  While  the  cost  of  computer  time  in  dollars  per  hour  in- 
creases with  the  memory  size  and  internal  computimg  speed  of  the  computer. 


“^Assuming  on  LP  Matrix  Density  of  1 to  5 percent. 


3 


the  cost  of  solving  linear  programming  problems  in  dollars  per  problem, 
usually  falls « This  increase  in  efficiency  is  analogous  to  the  familiar 
economies  of  scale,  though  here  ’*scale"  is  measured  in  time — in  micro 
(or  even  nano)  seconds.*^ 

USDA  LP/90  has  other  advantages  over  many  alternative  systems. 
Briefly,  these  all  lie  (1)  in  the  convenience  of  its  input  data 
format , (2)  in  the  external  control  the  user  has  over  the  program* s operation 
^nd  (3)  in  the  variety  of  related  computations  the  user  can  perform. 

The  system  was  partly  designed  for  special  USDA  uses  and  was 
acquired  to  facilitate  research  in  two  specific  areas,  (1)  recursive 
linear  programming  models  which  deal  with  regional  production  changes 
over  time  and  (2)  interregional  competition  models  which  have  very  many 
variables  and  constraints. 


d.  Our  Purpose  in  Presenting  This  Handbook 

Because  experience  has  shovm  the  great  usefulness  and  economy 
of  USDA  LP/90  in  agricultural  economics  research,  it  seems  highly 
desirable  to  make  a description  of  it  available  to  economists  everyi^here. 
That  in  fact  is  the  purpose  of  this  handbook.  So  as  to  make  the  handbook 
useful  to  as  wide  a variety  of  readers  as  possible,  it  has  been  made 
rather  more  comprehensive  than  was  first  planned.  For  this  reason  some 
readers  will  find  only  parts  of  the  handbook  useful.  The  readers  who 
know  the  theory  of  linear  programming  but  not  LP/90  will  be  interested 
only  in  Parts  III  toV.  On  the  other  hand,  those  who  wish  to  remind 
themselves  of  the  basic  theory  will  v/ish  to  read  Part  II  before  tackling 
the  description  of  the  program. 

It  is  also  possible  that  the  handbook  will  serve  as  a useful 
text  for  a one- semester  course  in  linear  programming,  such  as  now  being 
taught  in  many  agricultural  economics  departments.  Part  II  provides  an 
introduction  to  the  theory,  and  the  remainder  a guide  to  computational 
technique.  While  the  mathematics  of  the  latter  are  not  presented,  they  are 

2/ 

—'A  micro-second  = 1/1,000,000  second.  A nano-second  = 
1/1,000,000,000  second. 
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really  of  secondary  interest  to  the  applied  linear  progranmier . As  long 
as  USDA  LP/90  or  some  other  program  can  do  the  computations  for  him,  the 
economist  has  little  need  to  know  its  methodso  This  explains  the  only 
passing  reference  to  the  Simplex  Method  and  its  variants.  On  the  other 
hand,  a theoretical  knowledge  of  the  subject  is  indispensable  both  for 
structuring  models  and  for  interpreting  model  solutions. 

A principle  that  explains  the  length  of  the  book  is  that  for 
many  people  concrete  examples  facilitate  the  learning  of  any  subjecto 
The  section  summarizing  the  theory  contains  illustrations  of  each  major 
concept.  Part  IV  consists  entirely  of  six  examples  designed  to  show 
how  the  computer  system  works  on  a variety  of  linear  programming  and 
related  tasks. 

Before  the  latter  sections  are  reached  there  is  a section  which 
describes  the  main  features  of  the  computer  program  and  how  it  is  used. 

In  view  of  the  foregoing  principle  it  would  have  been  appropriate  to 
include  illustrations  in  this  section,  too.  However,  for  various  reasons 
all  of  the  computation  examples  were  gathered  together  in  Part  IV. 

USDA  LP/90  contains  so  many  possible  options  that  it  would  have 
been  impossible  to  illustrate  them  all.  On  the  other  hand,  once  the 
reader  understands  the  use  of  a few  of  them,  he  can  easily  apply  the 
remainder  when  desired.  Thus,  Part  IV  illustrates  the  use  of  the  system 
with  only  a few  possible  options.  Part  V then  provides  a reference  guide 
for  all  of  the  various  features. 

To  summarize,  the  handbook  serves  the  three- fold  purpose  of: 

(1)  Introducing  and  summarizing  the  theory  of  linear  programming 
and  some  related  computations; 

(2)  Describing  and  illustrating  the  use  of  the  USDA  LP/90 
computer  system; 

(3)  Providing  a user’s  reference  manual  for  the  possible 
program  options. 
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2.  A BRIEF  HISTORY  OF  USDA  LP/90 
a.  Predecessors  of  USDA  LP/90 

The  evolution  of  USDA  LP/90  began  in  the  latter  part  of  1952 
when  William  Orchard-Hays,  then  of  the  RAND  Corporation,  became  associated 
with  George  Dantzig,  originator  of  the  Simplex  Method.  Orchard-Hays* 
task  was  to  aid  in  designing  computer  programs  for  Dantzig *s  solution 
technique.  Their  collaboration  led  to  a series  of  computer  programs  for 
several  different  machines.  Each  nex7  program  incorporated  more  efficient 
computaticn  procedures  based  on  new  mathematical  developments  and  on  the 
experience  garnered  from  preceding  versions  [8].  Orchard-Hays*  efforts 
v7ere  continued  at  CEIR,  Inc.  along  with  other  collaborators,  where  the 
SCROL  LP  system  was  developed  for  the  SHARE*^  organization  with  the 
financial  support  of  several  American  business  corporations. 


b.  The  SHARE  LP/90  System 

With  the  advent  of  still  more  pov?erful  computers  the  LP/90  system 
was  designed.  A basic  version  of  this  program  was  made  publicly  available 
through  the  SHARE  organization.  By  this  time  the  system  had  become 
extremely  efficient  and  flexible  from  the  user*s  point  of  view..  Those 
v7ho  worked  on  the  system  included  Orchard-Hays,  David  Smith,  Nancy 
Dilenbeck,  Eli  Hellerman  and  Hugh  Powall, 

The  basic  computer  system  released  to  the  SHARE  organization  will, 
in  this  handbook,  be  called  SHARE  LP/90.  Its  basic  virtue  from  the 
user*s  point  of  view  is  (1)  its  ability  to  perform  many  LP  related 
computations  in  addition  to  basic  LP  and  (2)  its  ability  to  accommodate 
new,  special  purpose  features  without  modifying  the  already  existing 
system  (except,  of  course,  to  add  to  it). 


New  York. 


3/  ~ ” 

“'share  Distribution  Agency,  590  Madison  Avenue,  New  York  22, 
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c.  The  Proprietary  Version 

Primarily  under  the  direction  of  Eli  Hellerman  a great  variety 
of  special  purpose  features  have  been  added  to  the  basic  SHARE  system 
but  whose  use  is  reserved  by  the  Corporation  (CEIR)  for  competitive 
business  reasons.  The  latter  system  we  shall  call  ’’PROP  LP/90.”  It 
contains  all  the  features  of  the  former  and,  as  mentioned,  much  else 
besides.  This  system  can  be  acquired  by  commercial  arrangement  with 
the  Corporation  or  its  services  purchased  at  an  hourly  rate. 

d.  The  USDA  Version 

In  the  spring  of  1961  the  Farm  Production  Economics  Division 
contracted  with  CEIR  to  add  several  special  features  to  the  LP/90  system 
that  would  aid  current  research  in  recursive  linear  programming  and 
other  regional  programming  projects.  These  features  enable  the  user  to 
compute  an  LP  matrix  from  more  basic  data  matrices  and  to  compute 
solutions  to  a set  of  recursively  interdependent  linear  programming 
problems  during  a single  machine  ’’run." 

Because  the  CEIR  proprietary  features  were  found  to  be  of  great 
value  in  the  Farm  Production  Economics  Division  work,  it  was  decided 
to  acquire  them  in  addition  to  the  basic  SHARE  system  and  the  special 
USDA  features.  In  order  to  respect  the  •pronrietary  interests  of  the 
contractor,  the  USDA  agreed  to  make  these  features  available  only  for 
USDA  work  or  work  conducted  on  a cooperative  basis  with  the  USDA.  Any 
user  of  the  SHARE  LP/90  system,  however,  can  acquire  the  special  USDA 
features  by  arrangement  with  CEIR,  Inc.  The  use  of  the  PROP  features  can 
be  obtained  by  commercial  arrangement  with  that  Corporation. 

Much  of  this  manual  applies  equally  to  all  three  versions;  parts 
of  it  apply  only  to  the  PROP  or  USDA  versions.  The  latter  cases  are 
clearly  indicated  in  the  text. 

e . Future  Work 

No  doubt  development  of  computer  programs  for  linear  programming 
will  continue  uninterrupted.  The  USDA  LP/90  program  really  captures 
the  computing  system  at  one  point  in  time.  It  is  felt,  however,  that 
it  is  so  advanced,  that  it  will  remain  a useful  tool  for  research  even 
after  still  better  programs  for  still  faster  machines  are  designed. 
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3.  HOW  YOU  CM  USE  THE  PROGRM 
a.  The  Various  Versions  of  LP/90 

In  the  preceding  section  three  versions  of  LP/90  were  discussed. 
Actually  another  version  with  presently  existing  features  could  be 
envisioned.  This  would  be  the  SHARE  System  augmented  by  the  special 
USDA  features,  but  not  including  the  Proprietary  features.  We  shall 
call  such  a version  PUBLIC  LP/90.  Thus  we  have  the  following  tabula- 
tion summarizing  the  available  or  potentially  available  versions: 


LP/90 

VERSION 

FEATURES  INCLUDED 

IN  THE  PROGRM 

SHARE 

; PROPRIETARY 

USDA 

J NEW  FEATURES 
; AS  DEVELOPED 

SHARE 

Yes 

No 

No 

No 

PUBLIC 

Yes 

No 

Yes 

No 

USDA 

Yes 

Yes 

Yes 

No 

PROP 

Yes 

Yes 

Yes 

Yes 

The  fourth  row  is  provided  to  indicate  that  only  the  Proprietary 
version  of  LP/90  incorporates  all  new  features  as  developed.  We  shall 
discuss  only  briefly  each  version  in  turn. 

b.  How  to  Use  SHARE  LP/90 

The  SHARE  version  of  LP/90  is  available  to  any  researcher  with 

access  to  a suitable  computer.^  Information  about  it  can  be  obtained 

5/ 

by  writing  directly  to  the  SHARE  organization.-^  A great  deal  of  this 
manual  is  applicable  to  this  version  of  LP/90.  Where  special  PROP  or 
USDA  features  are  discussed,  the  text  indicates  this. 


4/; 

5/ 


See  Part  III, 


Section  4. 


See  note  3 above . 
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c.  How  to  Use  PUBLIC  LP/90 

PUBLIC  LP/90,  as  already  remarked,  is  the  SHAEIE  version  augmented 
with  the  special  USDA  features.  Such  a version  may  be  acquired  by  any 
researcher  by  sending  a copy  of  the  SHARE  program  master  tape  to  CEIR, 
Inc.^  The  latter  organization  will  add  the  USDA  features  to  the 
system  for  a nominal  fee, 

d.  How  to  Use  USDA  LP/90 

Because  it  contains  the  Proprietary  features  (and  for  that 
reason  the  proprietary  interests  of  their  owners  must  be  protected), 

USDA  LP/90  can  be  used  only  for  U.S.  Department  of  Agriculture  research, 
or  for  research  done  on  a cooperative  basis  with  that  public  agency. 
Arrangements  for  this  can  be  made  directly  with  the  Farm  Production 
Economics  Division.  Alternatively,  the  user  can  purchase  directly  from 
CEIR,  Inc,  the  services  of  this  program,  though  in  this  case  the  com- 
puting must  be  done  by  that  company. 

e.  How  to  Use  PROP  LP/90 

This  version  of  LP/90  is  the  only  one  that  can  be  depended  upon 
to  contain  all  of  the  latest  ’’bells  and  whistles”  and  for  that  reason 
in  the  future  it  may  have  certain  advantageous  options  that  various 
users  would  like  to  exploit.  Because  of  the  proprietary  nature  of  this 
system,  however,  arrangements  for  using  it  must  be  made  directly  with 
CEIR,  Inc.  As  the  special  USDA  featirres  are  public  property,  that 
company — like  any  other — is  free  to  use  them  commercially. 


Arlington,  Virginia. 


PART  II.  A REVIEW  OF  LINEAR  PROGRAMMING  AND 
SOME  RELATED  COMPUTATIONS 
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1.  THE  PRIMAL  LINEAR  PROGRAMMING  PROBLEM 
a.  Structure 


Linear  programming  is  the  problem  of  maximizing  (or  minimizing)  a 
linear  function  of  several  variables  which  are  subject  to  linear  inequality 
or  equation  constraints.  The  algebraic  notation  for  the  problem  may  be 
expressed  as  follows: 


(1) 

subject  to 
(2) 


It  = max  (z-  X-  + , , . + z x ) 

'll  mm 

X-  y • • • 9 X 
1 ’ m 


b-  - X,  + . . . + b,  X = c,  , 
11  1 1mm  1 


b.  - X-  + , . , + b,  X = c,  , 
kl  1 km  m k 


x^  = 0 


X = 0, 
m 


This  notation  says,  "choose  the  values  of  the  variables  x- , x 

★ 1 m 

which  gives  it  , the  largest  value  of  the  objective  function,  and  which  are 
consistent  with  the  "less  than  or  equal"  inequality  and/or  equation  con- 
straints represented  by  relations  2."  The  "objective  function  parameters" 

z, , z , the  "constraint  coefficients,"  b, - , ...,  b,  , and  the 

i m li  km 

"right-hand  side"  (RHS)  coefficients,  c^,  ...,  c^,  are  the  data  or 
parameters  for  the  problem. 

The  objective  function  parameters  arc  often  referred  to  as  the 

"cost  row."  The  columns  of  constraint  coefficients  are  usually  called 

processes  or  activities.  The  optimal  solution  to  the  primal  problem  (or 

primal  solution)  shall  be  denoted  x, , ...,  x ; these  values  give  the 

I m 

largest  value  of  jt  and  still  satisfy  all  the  constraints.  Any  set  of 
values  that  satisfy  the  constraints  is  called  a feasible  solution. 


b.  Example 

To  illustrate  the  primal  problem  we  shall  consider  a model  s.o 
simple  that  its  solution  can  be  found  readily  with  only  a few  elementary 
computations.  Even  so,  it  is  a model  seriously  put  forv;ard  as  a tool  for 
forecasting  agricultural  land  utilization  [6  ] . 
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Let  the  variables  and  the  objective  function  parameters  be  as  shown 
in  Table  1, 

Table  1:  Definition  of  Variables  and  Objective  Function  Parameters  for 

LP  Illustration 


Column  Index  j 

Meaning  of 

Profit  ($/Acre) 

i 

Acreage  of  rice 

66.67 

2 

'»  ” cotton 

65.22 

3 

" '*  soybean 

15.92 

4 

” ” oats 

14.10 

5 

” ” corn 

2.19 

z . 

J 


llie  objective  function  is  then 

(3)  = max  (66.67  x^  + 65.22  + 15.92  + 14.10 

X^ ) • • • 9 

2.19  x^) 

Also,  consider  a total  of  eleven  (k  = 11)  constraints  on  the  five  (m  = 5) 
variables  as  follows: 


X-  + X«  + X„  + X,  + X- 

1 2 3 4 5 

< 

1791 

*1 

< 

90 

^2 

< 

986 

^3 

< 

504 

X, 

< 

303 

^4 

^5 

< 

181 

"=1 

< 

- 74 

-^0 

< 

-681 

Am 

■*3 

< 

-356 

< 

-230 

«• 

• V — 

< 

-127 

5 

11 


The  first  of  these  is  an  overall  land  restriction,  the  second  five  are 
upper  bounds  on  the  naximum  acreage  allowed  in  each  crop,  and  the  last 
five  are  lower  bounds  on  the  mininium  acreage  in  each  crop.  These  last 
ten  constraints  might  be  called  "flexibility  constraints"  for  they 
specify  limits  on  the  decision  maker *s  flexibility  in  altering  output 
patterns.  They  may  exist  because  of  a desire  to  distribute  risk, 
because  of  irrational  or  habitual  production  goals. 


Table  2:  Summary  of  Constraints  for  LP  Illustration 


Row  Index  i 

Meaning  of 

Constraint 

Magnitude  of  RHS 
Coefficient  c. 
(1000’ 9 of  Acris) 

1 

Total  land  availability 

1791 

2 

Upper  bound 

on  rice 

90 

3 

M It 

" cotton 

986 

4 

II  II 

" soybeans 

504 

5 

II  II 

" oats 

303 

6 

It  It 

" com 

181 

7 

Lower  " 

" rice 

*•  74 

8 

II  II 

" cotton 

-681 

9 

II  II 

" soybeans 

-356 

10 

II  II 

" oats 

-230 

11 

II  II 

" corn 

-127 

The  role  of  the  latter  five  constraints  as  lower  bounds  is  more 
clearly  revealed  by  writing  them  in  the  equivalent  form: 

x^  = 74 

Xj  = 681 

(5)  X = 356 

X,  = 230 

^ X3  5i27 

/ The  solution  of  the  model  may  proceed  as  follows.  Let 

=!  74,  x^  = 681,  x^  = 356,  x^  = 230,  x^  = 121, 


That  is,  let  each  variable  equal  its  lower  bound 
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Adding  up  the  total  v/e  see  that 

^ ^2  ^ ^3  ^ “4  ^ ^5  " 

so  that  the  overall  land  restriction  is  satisfied  with  plenty  to  spare. 
Obviously  the  upper  bounds  are  satisfied  and  the  lower  bounds  are  of 
course  satisfied  as  equalities.  Thus  we  have  a feasible  solution. 

Next,  increase  the  acreage  of  the  most  profitable  crop,  rice, 
to  its  upper  bound,  90,  Now 

x_  + , . . + x^  = 1484, 

1 5 

still  less  than  the  total  land  available.  Therefore  we  increase  the 
acreage  of  the  second  most  profitable  crop  (cotton)  to  its  upper  bound 
(986)  and  find  that 


x^  + . , . + x^  = 1789 . 

Now  all  but  two  of  the  available  acres  are  left,  so  that  the  acreage 
of  the  third  most  profitable  crop  can  be  increased  by  just  exactly  that 
amount.  This  given  the  final  optimal  solution 

X*  = 90,  ^2  ” ^3  ” ^4  ” 

It  just  satisfies  the  overall  land  restriction,  ail  of  the  other  con- 
straints are  satisfied,  and  there  is  no  way  to  increase  profit  without 
violating  one  of  the  constraints.  The  total  value  of  the  program  is 
Zf  X*  + . , . + z^  X*  = jt*  or  $79,527.71. 


c.  Matrix  Representation 


In  matrix  notation  the  primal  problem  may  be  expressed  as 

•k  T 

(6)  Jt  = max  z x 

X 


subject  to 
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(7) 


u / \T  - sT  / 7/ 

where  z = • » » > * x — • • • > e*«j  a 

cind  where 


B = 


11 


\i 


b 


Im 


km 


In  the  numerical  example 


66.67 

II 

90 

a c = 

1791 

65.22 

986 

90 

15.92 

358 

986 

14.10 

230 

504 

2.19 

127_ 

303 

181 
- 74 
-681 
-356 
-230 
_-127 

and,  finally. 


7/ 

»*T'*  means  '‘transpose. " The  column  vector  x is  defined  to  be  the 
transpose  of  the  row  vector  (x^,  x^)*  Thus,  the  small  unsubscripted 

Latin  letters  always  refer  to  “‘'column  vectors. 
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d.  Additional  Remarks  on  the  Primal  Problem 


Note  again  that  the  use  of  less  than  or  equal  inequality  signs 
in  (2)  is  purely  a notational  convenience.  The  lower  bounds  naturally 
expressed  in  (4)  as  ’'greater  than  or  equal"  constraints- -were  converted 
into  the  form  used  in  (2)  simply  by  multiplying  through  both  sides  of 
the  statements  by  a minus  one  (and  reversing  the  inequality  sign). 

The  meaning  of  the  processes  or  activities,  that  is,  the  column 
of  b coefficients  comprising  the  B (constraint)  matrix,  depends  on  the 
particular  LP  problem  at  hand.  In  some  cases  the  coefficients  will 
represent  input,  coefficients  (as  in  the  first  row  of  our  example).  In 
other  cases  some  of  the  coefficients  may  be  negative  output  coefficients. 
In  some  cases,  as  is  in  the  flexibility  constraint  rows  of  our  example, 
there  is  no  natural  interpretation  of  the  coefficients  as  input  or 
output  coefficients.  The  important  point  is  that  any  problem  that  can 
be  put  into  the  form  of  relation  1 and  2 (or  of  6 and  7)  is  a legitimate 
LP  problem. 

A final  arbitrary  feature  of  relations  (1)  and  (2)  is  its  casting 
as  a maximizing  problem,  lie  might  just  as  well  have  written  (1)  as 


(!’) 


* 

jt  = min 
^1 


(2 


"^Z  x). 


X. , , , . , X '1  1 mm' 

m 


The  two  problems  are  really  equivalent  if  we  understand  that  the 

z-coefficients  in  (1*)  must  be  the  negatives  of  those  in  (1).  Tlie  latter 

representation  is  convenient  for  representing  cost  minimization  problems, 

while  the  former  more  naturally  express  profit  maximizing  problems. 

The  computer  system  LP/90  actually  is  based  on  (1*),  For  that 

reason,  the  objective  function  coefficients  for  profit  maximizing  problems 

must  be  entered  in  the  input  data  for  that  program  after  being  pre- 

multiplied  by  minus  one.  Positive  profits  v/ill  appear  in  the  data  as 

minus  numbers,  while  negative  profits  (losses)  will  appear  as  positive 

numbers.  Minimizing  such  a transformed  objective  function  will  in  fact 

qI 

maximize  the  desired  profit  function.^ 


— ^An  optional  way  of  converting  an  objective  function  to  be 
maximized  into  one  to  be  minimized  by  LP/90  is  available.  See  discussion 
of  SCALE,  Part  V, 
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2.  THE  DUAL  LINEAR  PROGRAMMING  MODEL 


a.  Structure 


To  every  primal  linear  programming  problem  there  corresponds  a 
dual  linear  programming  problem  with  the  following  structure: 


(8) 

subject  to 
(9) 


P = r,.  r ^k> 

1’  ’ m 


'’u  "^1  °kl  \ “ ^1’ 


• • > • 

b r + ...  + b r = z , 
Im  i Km  K m 


..Jo 


r = 0. 

k 


This  notation  says,  '‘choose  the  values  of  the  (dual)  variables 

* 

r^,  , r.  c , which  gives  p , the  smallest  value  of  the  dual  objective 
function  (8)  consistent  with  the  constraints  represented  by  9.  We  note 
that  the  rows  of  b coefficients  correspond  to  the  columns  of  the  B matrix 
in  the  primal  problem;  that  the  objective  function  coefficients  are  the 
RHS  elements  of  the  primal  problem;  that  the  RHS  elements  are  the  objective 
function  coefficients  of  the  primal  problem;  and  finally,  that  the  v/eak 
inequality  sign  in  (8)  are  "greater  than  or  equal"  rather  than  "less 
than  or  equal"  inequality  signs,  A feasible  solution  is  any  set  of  values 
r- , ...,  r,  that  satisfies  the  relation  of  (9),  while  an  optimal  solution 
is  any  feasible  solution  r^^,  r^^  that  yields  p , 


b.  Example 


The  dual  of  the  problem  in  the  example  of  Section  lb  is  as  follows: 

1791  r,  + 90  r^  + 968  r^  + 504  r,  + 303  r^ 


* 

P = 


min 

9 • • • » 


+ 181  r.  - 74  r.  - 681  r_  - 356  r - 230  r._  - 127  r-  , 
6 7 8 9 10  11 


Subject  to  the  constraints; 
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ri 


-r. 


+r. 


-r. 


+r 


4 


-r. 


+r, 


-r 


10 


+r. 


-r 


11 


> 

> 

'V. 

> 

> 


66,67 

65.22 

15.92 

14.10 

2.19 


The  solution  of  this  dual  problem  is  not  quite  so  obvious  as  is  that  of 
the  primal  problem.  Once  one  knows  a bit  more  of  the  theory  of  linear 
programming,  however,  the  solution  reduces  to  comparably  simple  calculations. 
This  will  be  sho^m  in  Section  3,  below.  We  shall  see  there  that  the 
solution  is 


* 

^1 

* 

^2 

* 

r 


3 
* 

4 
* 

5 
* 

6 
* 

7 
* 

8 

* 

9 
* 

10 
* 


= = 15.92 

= 66,67  “ “ ^3  “ 50.75 

= 65.22  “ = ^2  " ^3  ~ 

= 0 
= 0 
= 0 
= 0 
= 0 
= 0 


= r-  - 14,10  = z^  - z,  = 1,82 
1 3 4 


r^^  = r^  - 2.19  = z^  - z^  = 13.73 


The  value  of  the  dual  program  p = $79,527,71. 


c.  Matrix  Representation 

In  matrix  notation  the  dual  problem  is  expressed  as 


(10) 


* T 

p = min  r c, 

r 


subject  to 
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(11) 


B r = 2 


r = 0, 


where  r = (r^,  B means  the  transpose  of  B (rows  and  columns 

interchanged).  Thus  in  our  example. 


T 

B = 


0 -1 

0 0 


0 

0 

0 

0 

-1 


3.  SOl^IE  THEORETICAL  PROPERTIES  OF  DUAL  LINEAR  PROGRAMS 


In  this  section  the  theory  of  dual  linear  programs  is  highlighted. 
Proofs  are  not  given.  These  may  be  found  in  the  works  cited  in  the 
References  included  at  the  end  of  the  handbook. 


a.  Existence  of  Solutions 

A necessary  and  sufficient  condition  that  dual  linear  programs 
have  optimal  solutions  is  that  they  both  have  feasible  solutions.  It  is 
not  sufficient  if  the  primal  but  not  the  dual  (or  vice  versa)  has  a feasible 
solution.  In  our  examples  feasible  solutions  are  easily  found  by  inspection. 


b.  Duality  Theorem 

If  there  exist  optimal  solutions  to  the  dual  linear  programming 

problems,  then  the  optimal  values  of  their  objective  functions  are  equal, 

that  is,  X = p . Conversely,  feasible  solution  vectors  x and  r such 
T - T 

that  2 X = r c are  optimal.  This  property  provides  a check  on  the  dual 
solutions  of  any  empirical  problem.  We  note  that  in  the  example  of 

it  it 

Section  lb  and  2b,  m = p so  that  the  dual  solution  found  must  indeed 
be  optimal. 
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c.  Meaning  of  the  Dual  Variables 

The  optimal  dual  variables,  r^,  r^^  are  the  marginal  values, 

respectively^  of  the  RHS  constants  c^,  c^^.  That  is,  they  show  hov; 

much  the  objective  function  would  be  increased  by  a small  increase  in 
the  values  of  the  right -hand- side  constants.  In  calculus  notation 

(12)  r*  = i = 1,  ...,  k. 

* 

Thus,r.  is  the  partial  derivative  of  the  optimal  value  of  objective  function 
with  respect  to  the  i RHS  coefficient. 

Turning  back  to  the  example  of  Section  2b,  we  find  that  if  the 
total  amount  of  land  available  is  increased  one  acre,  the  increase  in 
profit  will  be  $15,92.  This  is  because  all  crops  are  being  grown  at 
their  maximum  or  minimum  bounds  except  soybeans.  The  latter  can  be  in- 
creased one  acre  without  violating  any  constraints.  Of  course,  oats  of” 
corn  could  also  be  increased  one  acre,  but  as  they  are  less  profitable 
than  soybeans,  that  would  not  be  the  optimal  response. 

It  will  also  be  seen  that  if  the  upper  bound  on  rice  is  increased 
one  acre,  the  increase  in  the  total  value  of  the  program  is  $50.75.  As 
it  turr^  out,  this  is  because  rice  can  be  increased  one  acre  grossing  an 
additional  $66.67,  but  this  must  be  done  at  the  expense  of  one  acre  of 
soybean  production.  Thus,  we  get  ” ^2’  Cotton  acreage  could  have 

been  reduced  one  acre  instead  of  soybeans,  but  that  would  not  have  been 
optimal. 

The  reader  may  similarly  interpret  the  remainder  of  the  dual 
variables  in  the  example. 


d.  ’’Tight”  (Eq^uated)  and  ’’Loose”  (Slack)  Constraints 

A ’’tight”  constraint  is  one  that  is  satisfied  as  an  equality  by 
the  optimal  solution,  a ’’loose”  constraint  is  one  that  is  satisfied  as 
an  inequality,  A tight  primal  constraint  would  mean  that  the  corresponding 
’’resource”  is  exhausted  by  the  optimal  primal  solution,  A loose  primal 
constraint  would  mean  that  some  of  the  corresponding  input  is  unused 
by  the  optimal  production  plan. 
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If  in  the  optimal  solution,  a given  primal  constraint  is  loose, 
then  the  corresponding  dual  variable  is  zero.  If  a given  constraint 
is  tight,  the  corresponding  dual  variable  V7ill  be  positive.  There  will 

9 / 

be  as  many  positive  dual  variables  as  there  are  primal  equated  constraints,— 
Conversely,  there  V7ill  always  be  one  zero  activity  level  for  every  loose 
dual  constraint  and  a positive  one  for  every  tight  dual  constraint.  Tims, 
there  will  be  as  many  positive  primal  variables  as  there  are  dual  equated 
constraints.  The  tight  constraints  are  frequently  called  equated  con- 
straints and  the  loose  constraints  are  frequently  called  slack  constraints. 

In  our  numerical  example  the  optimal  primal  solution  satisfied 
five  constraints  as  equalities,  constraints  1,  2,  3,  10, and  11  (the 
land,  rice  and  cotton  upper  bounds  and  oats  and  corn  lower  bounds). 

These  correspond  to  the  five  positive  dual  variables  r^,  r^,  r^,  r^Q,and 
All  of  the  other  primal  constraints  were  loose  and  their  corresponding 
dual  variables  were  zero. 

In  this  example,  because  of  the  positive  lower  bound  on  each 
activity  level,  all  five  primal  variables  must  be  positive.  Ue  know  in 
advance  therefore  that  there  must  be  five  equated  primal  constraints 
with  five  positive  dual  variables,  though  which  five  we  do  not  know. 

As  there  are  exactly  five  dual  constraints  and  as  we  know  that  all  five 
primal  variables  will  be  positive,  we  knov/  that  all  five  dual  constraints 
will  be  tight  or  equated. 


A device  for  keeping  track  of  the  tight  and  loose  constraints  will 


be  convenient  in  V7hat  follon^s.  Let  K, 


= i 1 

1 I n*  •••’  J 


be  the  set  of 


row  indexes  corresponding  to  the  tight  primal  constraints  (and  to  the 
positive  dual  variables).  Let  ^2=1^  ^*+1^  •••’  Sc  } 
row  Indexes  associated  with  the  loose  primal  constraints  (and  zero  dual 
variables).  Also,  let  = -f  the  column  indexes 

corresponding  to  the  tight  dual  constraints  (positive  primal  variables) 
and  = / jm*+l*  ***'  column  indexes  corresponding 

to  the  loose  dual  constraints  (zero  primal  variable).  Thus, 


^This  will  not  be  true  if  the  tight  constraints  are  not  all 
linearly  independent.  In  such  a case  some  of  the  associated  dual  variables 
may  be  zero,  same  qualification  holds,  mutatis  mutandis,  for  the 

following  tv7o  sentences.  ' 
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a.,  x-+.,.+a.  X =c., 
il  1 im  m 2.* 


r = 0;  i € Ki 


a.-x,+,o.+a.  X <c., 
il  1 im  m i’ 


a r-  + , . . + a-  . r,  = z . , 

Ij  1 kj  k j ’ 

a.  . r-  + ...  + a,  . r,  > z. , 

Ij  1 kj  k j ’ 


r.  = 0;  i € K2 
j e 

X.  = 0;  j € M«. 


e.  Systems  of  Equated  Constraints 


Let  us  form  from  among  primal  and  dual  systems  of  weak  inequality 
constraints  2 and  6 the  sets  of  primal  and  dual  equated  constraints.  For 
any  primal  variable  that  is  zero  (none  in  this  example)  we  can  omit  the 
corresponding  column  of  B matrix  coefficients,  and  for  any  dual  variable 
that  is  zero  we  can  omit  the  corresponding  row  of  B matrix  coefficients. 


We  have 

then 

the  primal  system  of  equated 

constraints 

Xi  + x^  + 

X-  + X,  + X-  = 

3 4 5 

=1  = 

1791 

Xf  + X2  + 

X3  + + X3  = 

90 

(13) 

^^2 

= 

•=3  = 

986 

- *4 

^10  " 

-230 

- ^ = 

=11  = 

-127 

and  the 

dual 

system  of  equated  constraints 

^1 

66.67 

= z 

j. 

^3 

65.22 

= z 

(14) 

• 

15.92 

= z 

‘ ^10 

14.10 

= z 

- 

2.19 

= 2 

"4  = 

= *^6  = >^7  = 

= 

>^9 

= 0. 


Having  divided  the  varijables  into  positive  and  zero  classes,  we 
can  represent  the  positive  primal  and  dual  variables  as  solutions  to  the 
primal  and  dual  systems  of  equated  constraints, respectively. 
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An  even  more  convenient  way  of  representing  the  solution  is  in 
matrix  form.  Thus,  13  may  be  represented  as 


(13’) 


“11111“ 

^1 

=1 

“ 1791  “ 

1 0 0 0 0 

*2 

=2 

90 

0 10  0 0 

^3 

= 

=3 

= 

986 

000-10 

=10 

-230 

_0  0 0 0 -1_ 

Cl  I 

-127 

- 5-” 

— ll-> 

and  14  as 


“1 

1 

0 

0 

0“ 

^i~ 

=1 

1 

0 

1 

0 

0 

^2 

=2 

(14*) 

1 

0 

0 

0 

0 

^^3 

^3 

= 

1 

0 

0 

-1 

0 

2/ 

10 

4 

_1 

0 

0 

0 

-1_ 

z_ 

ir 

- 5- 

The  solution 

to 

these 

are  then 

— 

rnm* 

(15) 


^2 

^3 

II 

-^5- 

“01000“ 

“1791“ 

0 0 10  0 

90 

1-1-1  1 1 

986 

000-10 

-230 

1 

0 

0 

0 

«“127_ 

66,67 

65.22 

15c92 

14.10 

2.19 


(16) 


~’^i~ 

CM 

U 

^3 

II 

^10 

^11 

“00100“ 

“66.67 

10-100 

65.22 

01-100 

15.92 

001-10 

14.10 

0 0 10-1 

- 2.19 

The  matrix  in  (15)  is  the  inverse  of  the  matrix  in  (13*)  and 
that  in  (16)  is  the  inverse  of  that  in  (14*).  Moreover,  the  matrix  in 
(14*)  is  the  transpose  of  that  in  (13*)  and  the  matrix  in  (16)  the 
transpose  of  that  in  (15) ! 

Recallirxg  now  our  index  sets  M^, 
following  matrix  and  vectors: 


we  can  form  the 
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B*  = 

tb,.] 

i 

€Ki 

X*  = 

<Xj).  z'  = (Zj) 

i 

6 Ml 

x»*  = 

(Xj),  z"  = (Zj) 

j 

e M2 

r * = 

(rj^),  c'  = (cp 

i 

r»*  = 

(r.),  c"  = (cp 

i 

(Note  that  ’ does  not  denote  transposition  in  this  manual.) 
Thus  our  dual  system  of  equated  constraints  may  be  written  as 


(17a)  B’  X*  = c*,  X**  = 0 

(17b)  r'  = z',  r"  = 0. 


Thus  B'  is  comprised  of  the  columns  and  rows  of  B that  correspond  to 
tight  prinal  and  dual  constraints. 

The  preceding  heuristic  discussion  illustrates  the  following 
principles.  Feasible  vectors  x and  r are  optimal,  if  and  only  if, 
they  satisfy  dxjal  systems  of  equated  constraints.  Further,  if  B*  is 
non- singular,  i.e.  it  has  an  inverse  (B’)  ^ then  17  is  called  a non- 
singular  dual  system  of  equated  constraints,  A solution  satisfying 
a non- singular  dual  system  of  equated  constraints  is  called  an  extreme 
vector,  the  non-zero  elements  of  vzhich  can  be  written 


(18a) 

(X*)' 

= (B')‘^  C 

(x*) ‘ = 0 

(18b) 

(r*)' 

T -1 

= (B'b  z- 

(r*) » • = 0 

Now  (18b)  can  be  re- expressed  as 

(19)  (r*)'  = (B’’^)'^  z’  = (B'*S^  z=  , 


- ^ ic 

so  that  once  the  B*  is  found  which  gives  (x  ) * , (r  ) * can  be  found  by 
a matrix  multiplicatiori.  As  our  example  of  sections  l.b  and  2,b  had  an 

ic 

extreme  solution,  we  found  p in  this  manner. 

The  solution  to  dual  linear  programs  are  not  necessarily  unique. 
By  this  we  mean  that  several  different  primal  and  dual  solution  vectors 
may  be  found  that  satisfy  several  different  nonsingular  dual  systems  of 
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equated  constraints.  That  is,  there  may  be  several  extreme  optimal 

vectors  to  any  problem.  However,  the  following  theorem  relates  all 

solution  to  the  extreme  solutions. 

1 pi  p 

Let  X , ...,  x^;  r , ...»  r^  be  p optimal  extreme  solutions  of 
a given  LP  problem  (all  having  the  same  values  jt^=  ...  = = p^). 

ic  ^ 

Then  primal  and  dual. vectors  x and  r are  solutions  if  and  only  if 

there  exist  scalers  , ....  \ not  all  zero  such  that 

1 P 


(20a) 

* 1 
X = X + . . . 

+ \ 
P 

(20b) 

* 1 

r = r + ... 

+ \ 
P 

f.  Comparative  Cost  Factors  (the  arid  Small  Primal  Changes 


Noted  above  is  the  interpretation  of  the  dual  variables  as  partial 

derivatives  or  marginal  values.  From  the  dual  variables  a second  set  of 

variables  can  be, derived  that  indicate  the  relative  costs  of  using 

activities  with  zero  process  levels  in  the  optimal  solution.  If  we  let 
th 

b.  be  the  i column  of  the  ori.^inal  constraint  matrix  then  the  relations 

j 

T * > 

(20-1)  b:  r = z. 

3 3 


are  satisfied  by  the  optimal  dual  variables.  If  we  let 

(20-2)  d.  = z.  - bT  r* 

J J J 

th 

then  d^  is  the  relative  cost  per  unit  of  using  the  j activity  when  its 
inputs  are  valued  by  their  optimal  marginal  values.  For  columns  in  the 
equated  constraint  matrix  (20-1)  is  an  equality  so  that  the  corresponding 
d^  is  zero.  For  columns  not  in  the  equated  constraint  matrix  (20-1)  is 
satisfied,  in  general,  as  an  inequality,  implying  a positive  d.. 

A small  d^  suggests  that  the  corresponding  process  could  be  sub- 
stituted for  an  optimal  one  .v/ith  only  a small  sacrifice  in  profit,  while 
a large  d^  suggests  the  converse.  For  this  reason  many  linear  programming 
routines,  including  LP/90,  provide  for  computing  these  coefficients 
after  the  attainment  of  an  optimal  solution. 
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It  is  also  possible  to  show  that  the  elements  of  the  inverted 

equated  constraint  matrix  can  be  interpreted  as  partial  derivatives.  More 

t h 

specifically,  if  bl.  is  the  ij  element  of  the  matrix  then 


(20-3) 

a X* 

^ ^ = b!., 

0 XJ 

j € M^,  ^ ^ \ 

a x" 

(20-4) 

ft" 

j M^,  i 

i 


In  v7ords,  this  means  that  the  elements  of  the  inverse  of  the  equated 
constraint  matrix  shox7  how  much  the  optimal  primal  variables  would  change 
with  a marginal  change  in  the  right-hand  side  constants,  given  that  the 
system  of  equated  constraints  is  not  changed. 


4.  PARAMETRIC  PROGRAMMING 

Very  frequently  the  researcher  is  not  interested  merely  in  a 
single  LP  solution.  Rather  he  wishes  to  know  how  the  optimal  solution 
of  a given  LP  model  changes  as  one  or  more  of  its  parameters  are  modified. 
As  there  are  three  basic  sets  of  data  or  coefficients  in  an  LP  model, 
viz,  the  c-vector,  the  z-vector,  and  the  B-matrix,  there  are  three 
(major)  corresponding  types  of  parametric  programming  operations.  The 
first  of  these  is  denoted  (in  LP/90  lingo)  '‘PLP"  and  is  frequently 
called  ’'parametric  right-hand- side"  or  "resource  mapping."  The  second 
is  denoted  (again  in  LP/90  language)  "PCR"  and  is  more  commonly  known 
as  "parametric  objective  function,"  "parametric  cost  row,"  or  "price 
mapping."  The  third,  does  not  (as  far  as  the  present  author  knows)  have 
a conrmonly  accepted  name,  though  by  analogy  with  the  other  t3rpes  of 
parametric  programming  it  might  be  called  "parametric  constraint 
coefficient"  or  "technical  coefficient  mapping,"  or,  paraphrasing  Simon 
[12] , "Trigger  Effect  Analysis."  Each  of  these  will  be  briefly  described 


in  turn. 
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a.  Parametric  Right -Hand -Side  or  Resource  Mapping  (PLP) 

* * X 

Suppose  X = (x  , • . . , X ) is  the  optimal  primal  solution  and 
* * * ^ ® 

r = (r- , r ) is  the  optimal  dual  solution  of  a given  LP  problem. 

■*"  R ^ 

IJe  wish  now  to  see  hov/  r and  x change  as  the  RHS  coefficients  are 
changed  in  some  fixed  proportion.  Let  some  constants 

positive  or  negative  (or  zero).  The  PLP  problem  may  be  vnritten  as 
follows : 


(21) 

subject  to 


/ (0)  = 


max 


X-  , . . . X '“I  1 

1 m 


(z-  X.  + . . . + z X ) , 


m m 


(22) 


b,,  X.  + ...  + bT  X S c,  + 0 V- 
11  1 Im  m 1 1 


• • 

• • 

e 9 


b,  , X,  + . . . + b,  X < c,  + 6 V, 
kl  1 km  m - k k 


x^  = 0 


' X = 0 
m 


for  all  0 S 0 = 9. 


This  problem  always  starts  after  solving  the  basic  linear  programming 

problem  with  0=0.  Then  0 is  increased  continuously  up  to  0.  As  it 

increases  it  , x and  r will  change.  Usually  the  constraints  which  are 

tight  or  loose  (and  therefore  the  system  of  dual  equated  constraints) 

will  change  status  as  0 is  increased.  These  changes  are  made  in  discrete 

jumps  (or  in  continuous  linear  segments),  however,  in  between  v/hich  a 

linear  interpolation  may  be  made  for  any  desired  solution  variable 

(it  , X- , ...,  X , or  r. , ...,  r,  ) , Tne  value  of  0 may  be  infinite.  The 
X ml  k 

v-coefficients  are  sometimes  called  change  coefficients  and  the  vector 
comprised  of  them,  the  change  vector. 

In  matrix  notation  the  PLP  problem  is  written 

* T 

Jt  (0)  = z X 


(21') 
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subject  to 

(22')  Bx=c  + 0v,  x = 0 

T 

v/here  0 v = •••>  s-lso  note  that  the  dual  to  this 

problem  is 

p*  (0)  = (c  + 6 v) 

subject  to 

_T  > 

B r ^ z. 

^ Vv  ^ 

The  optimal  values  3T  and  p and  the  optimal  dual  solution  vectors  x 
* 

and  r may  be  regarded  as  being  defined  as  implicit  functions  of  the 
single  parameter  0.  The  object  of  PLP  algorithms,  such  as  the  one  used 
by  LP/90,  have  the  task  of  determining  these  magnitudes  as  explicit 
functions  of  0. 


b.  Example 


In  order  to  illustrate  PLP  we  invoice  our  original  example  in  this 
nev7  context.  Everything  is  the  same  as  before  except  for  defining  a 
change  vector.  We  shall  consider  a change  vector  with  v^  = 1.0  and  all 
other  elements  zero,  that  is,  we  shall  consider  a continuous  change  of  a 
single  RHS  element,  the  overall  land  availability.  The  linear  inequalitie 
of  (22)  no\7  become 


(25) 


X-  + X_  + X_  + X,  + x_ 

1 2 3 4 5 

''l 


X, 


X, 


X 


4 


-X. 


•X, 


-X, 


-X, 


“X, 


< 

< 

< 

< 

< 

< 

< 

< 

< 

< 

< 


1791  + 0 1,0 
90 
986 
504 
303 
181 
- 74 
-681 
-356 
-230 
-127 
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The  objective  function  (relation  3)  is  the  same  as  before.  The  solution 

^ ^ ^ 

for  0 = 0 is  already  knovm  and  is  x.  = 90,  x^  = 986,  x_  = 358,  x^  = 230, 

i(  ^'k  ie 

x^  = 127.  Of  these  optimal  solution  values  x^  and  x^  are  at  their  upper 

bounds  so  that  further  increase  is  not  possible.  x!J  however,  the  crop 

(soybeans)  next  in  line  in  profitability  can  be  increased  to  its  upper 

bound  of  504,  or  an  increase  of  504  - 358  = 146.  Thus  0 may  increase 

from  0 to  146  without  changing  the  dual  system  of  equated  constraints 

that  describe  the  solution.  At  8 = 146,  however,  a second  dual  system 

of  equated  constraints  will  describe  the  solution  as  well  as  the  initial 

system  [see  Section  3,e,  equations  (13)  and  (14)],  The  solution  is,  in 

this  case, 

X*  = 90,  X*  = 986,  X*  = 504,  x“  = 230,  x*  = 127, 
and  the  second  dual  system  of  equated  constraints  would  be 


(26) 


(27) 


+ Xj  + X3  + + X 


X, 


X. 


-X, 


1937 

90 

986 

504 

-127 


1791  + 0 1.0 


66.67 

65.22 

15.92 

14.10 

2.19 


As  0 is  increased  beyond  146,  dual  system  (26)  and  (27)  will 
describe  the  solution  until  (and  including)  0 = 219.  At  this  point  the 
optimal  solution  is 


it  it  * 

x^  = 90,  x^  = 986,  x^ 


504,  x^  = 303, 


127, 


and,  as  0 increased  from  146  to  219,  the  acreage  of  oats — the  most  profit- 
able crop  that  is  not  already  at  its  upper  bound --increases  continuously. 

Again,  at  0 = 219  a second  dual  system  [other  than  (26)- (27)]  will 
describe  the  optimal  solution: 


28 


(28) 


end 


(29) 


X,  + X^  + + X.  + X 


1 2 


X. 


X. 


4 5 


2010  = 1791  + 0 1.0 

SO 
986 
504 
303 


66.67 

65.22 

15.92 

1-'’.,10 

2,19. 


Like  the  first  instance  the  values  of  any  of  the  solution  variables  may  be 
interpolated  linearly  for  the  values  146  < 6 < 219. 

In  a similar  manner  v/e  find  that  from  0 = 219  to  0 --  273  a linear 
interpolation  can  be  made  between  the  values  at  219  and  273.  For  the 
latter  value  of  6 the  solution  is 


= 90, 


= 986,  x^ 


504, 


* 

X,  = 303, 
4 


* 


At  this  point  no  change  in  solution  is  effected  through  a rise  in  0,  for 
with  each  variable  at  its  upper  bound,  none  can  be  increased.  Consequently, 
though  0 can  be  increased  indefinitely  beyond  this  point  v/ithout  affecting 
the  feasibility  of  the  program,  there  is  no  point  in  doing  so.  With  a 
little  forethought  we  might  have  anticipated  this  result,  and  planned 
at  the  beginning  for  a range  for  PLP  of  0 =0  = 273  (i.e.  G — 273).  We 
may  note  that  a second  dual  system  of  equated  constrarnts  can  represent 
the  solution  at  0 = 273  in  addition  to  (28)  - (29). 


It  is 


(30) 


and 


X. 


X. 


X, 

4 


= 90 

= 936 
= 504 
= 303 
x^  = 181 


= 66.67 

= 65.22 

= 15.92 

= 14.10 

rg  = 2.19 


(31) 
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The  results  of  this  exercise  in  PLP  are  summarized  in  Tables 

3 and  4 and  in  Figures  1 to  3.  Figure  1 shows  the  program  value 
* * 

(tt  = p ) for  each  value  of  9;  Figure  2 shows  the  values  of  each  primal 
variable  as  functions  of  9;  finally,  Figure  3 shows  the  values  of  each 

•k 

dual  variable  as  functions  of  9«  Note  that  n changes  at  each  value  of 

A 

9 until  9 = 273  is  reached,  but  at  a decreasing  rate»  However,  the  change 

JL. 

in  IT  occurs  in  discrete  linear  segments  each  one  of  which  is  associated 
with  a unique  dual  system  of  equated  constraint So  Also,  note,  both  the 
discrete  jumps  and  sloping  linear  segments  of  the  acreage  response  curves, 
and  the  purely  discrete  jumps  in  the  dual  variableso  These  results  of 
course  depend  on  the  particular  structure  of  this  LP  example « 
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Table  3:  Summary  of  Primal  Solutions  for  PL?  Example 


Primal 
Index  j 

Objective 

Coefficients 

z . 

» J 

O 

CD 

0=146 

9=219 

0=273 

JU 

0\ 

X. 

j 

* 

J 

' ' 

•k 

X . 

J 

* 

X. 

T 

J 

1 

a. 

66.67 

90 

90 

90 

90 

2 

65.22 

986 

906 

986 

986 

3 

15.92 

358 

504 

504 

504 

4 

14.10 

230 

230 

303 

303 

5 

2,19 

127 

127 

127 

181 

Primal 

•k 

Value 

TT 

79,528 

81,852 

82,881 

83,000 

Table  4:  Summary  of  Dual  Solutions  for  PLP  Example 


Dual 

0 

= 0 

0 

= 146 

Variable 

Index 

i 

RHS  Elem. 
c.  + 0v. 

L 1 

Dual  Var, 
-k 
r . 

1 

RHS  Elem, 
c^.  + 

Dual  Var. 

"i 

1 

1791 

15.92 

1937 

14.10 

2 

on 

^ w 

50.75 

90 

52.57 

3 

986 

49.30 

986 

51.12 

4 

504 

0.00 

504 

1.82 

5 

303 

0.00 

303 

0.00 

6 

181 

0.00 

181 

0.00 

7 

- 74 

0.00 

- 74 

0,00 

8 

-681 

0.00 

-681 

O.CO 

9 

-356 

0.00 

-356 

0.00 

10 

-230 

1.82 

-230 

0.00 

11 

-127 

13.73 

-127 

11.91 

Dual 

ii 

k 

Value 

p = 

79,528 

P = 

81,852 

0 

= 219 

0 

= 273 

1 

2010 

2.19 

2064 

0.00 

2 

90 

64.48 

90 

66,67 

3 

986 

63.03 

986 

65.22 

4 

504 

13.73 

504 

15.92 

5 

303 

11.91 

305 

14,10 

6 

181 

0.00 

181 

2.19 

7 

- 74 

0.00 

- 74 

0.00 

O 

O 

-681 

0.00 

-631 

0.00 

9 

-356 

0.00 

-356 

O.CO 

10 

-230 

0.00 

-230 

0.00 

11 

-127 

0.00 

-127 

0.00 

Dual 

* 

P = 

Value 

P = 

82,881 

83,000 

Program  Value 
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FIGURE  1 

OPTIMi\L  VALUE  OF  EXAMPLE  PRCGR*\M  AS  A 
FUNCTION  OF  TOTAL  LAND  .(=  + 8) 


Process  I.evels  (Acr 
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FIGURE  2 

OPTIMAL  PROCESS  LEVELS  OF  EXAMPLE  PROGRAM  AS 
FUNCTIONS  OF  TOTAL  LAND  (=  + 0) 


Dual  Variables  (Dollars 
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60.00 


50.00 


■ ■ — Marginal  Value  of  Upper  Bound  on  Rice 

^ ^ Marginal  Value  of  Upper  Bound  on  Cott 

(2^3) 


^67  ’ 


64.48 


on 


52.57 


5SL2A, 


T 


4 


40.00 


30.00 


20.00 


10.00 


H / I 

49.30 

^ Marginal  Value  of 
Marorinal  Value  of 


A 

1 — 

-C 

4 i ( 1 1 1 1-* 


51.12 


Land  (r^^) 


1 — t 


65.22 


Upper  Bound  on  Soybean^  (r^) 

I 

Upper  Bound  on  Oats  (ri) 


^ ^ — ^Marginal  Value  of 


• - - — Marginal  Value  of j Upper  Bound  on  Corn  (r|) 


15.92 

y-  %-jK' 


14.10 


^ -g  .Q.O 


1.82 


-U5^i 

-e-o* 

14.10 


2.19 

- • i 


yw  I 


1791 

(0=0) 


1937  2010  2064 

(0=146)  (0=219)  (0=273) 

Total  Acreafre  = c,  + 9 


FIGURE  3 : OPTIMAL  DUAL  VARIABLES  OF  EXAMPLE  PROGRAM  AS  FUNCTIONS 

OF  TOTAL  LAND  ( = + 0) 
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Co  Parametric  Objective  Function  of  Price  Mapping  (PGR) 

We  wish  now  to  see  how  the  optimal  solution  changes  as  the 
objective  function  parameters  are  changed  in  some  fixed  proportion.  Let 
a^,  o..,  be  some  constants,  positive  or  negative  (or  zero).  The  PGR 
problem  may  be  written  as  follows. 

(32)  n (0)  = max  [(z-  + 0a- )x-  + ...  + (z  + 0a  )x  ] 

Xt,...,x  1 11  m mm 

1 m 

for  all  0=0=0,  subject  to 

b- -x^  + , . , + b^  X = c- 
11  1 1mm  1 


(33) 


o • ^ , 

b,  -X-  + . • . + b,  X = c,  . 
kl  1 km  m k 


In  matrix  notation 


(34)  n (0)  = max  (z  + 0a)  ^x. 


< < 

0 = 0 = 0 


subject  to 
(35) 


< 

B X = c 


X 

where  a = (a^,  •••,  a^)  . The  dual  problem  is  written 


* T 

p (0)  = min  r c 


subject  to 


T > 

B r = z + 0a,  r = 0. 


This  problem  always  starts  after  solving  the  basic  LP  problem 

-k 

with  0=0.  Then  0 is  increased  continuously.  As  it  increases  x , and, 

•k  k 

of  course,  n and  r will  change.  Usually  the  constraints  which  are 
tight  or  loose  (the  system  of  equated  constraints)  will  change  status 
as  0 increases.  As  with  PLP  the  changes  are  made  in  discrete  jumps,  or 
in  continuous  linear  segments--as  the  case  may  be.  In  the  latter  case 
linear  interpolation  between  the  critical  solutions  yield  the  value  of 
any  desired  solution  variable.  The  value  of  0 may  be  infinite.  The 
a-coef f icients  are  sometimes  called  change  coefficients  and  the  vector 
comprised  of  them,  the  change  vector. 
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The  prircary  significance  of  PCR  from  the  economists  point  of  viev7, 
is  the  fact  that  it  can  be  used  to  derive  supply  functions  of  the  neo- 
classical variety.  This  V7ill  be  illustrated  in  the  next  paragraph. 

d.  Example  of  Parametric  Objective  Function  of  Price  Mapping  (PCR) 

Cur  original  sample  problem  will  continue  to  serve  adequately  our 
need  for  illustration.  It  needs  to  be  modified  only  in  the  objective 
function  to  account  for  the  change  coefficients,  Ue  shall  let  the  change 
coefficient  for  the  first  process  be  the  negative  yield  of  cotton  lint 
in  hundred  weight  (cwt)  per  acre,  and  suppose  its  value  to  be  -4.00,  that 
is,  = -4.00.  The  remaining  change  coefficients  are  assumed  equal  to 
zero,  (a^  “ ^3  “ ^4  ” ^5  ~ • Consequently,  the  parametric  objective 

function,  as  a function  of  the  change  parameter  0,  is 

(36)  / (0)  = max  66,67  x + (65,22  - 0 4.00)  x + 15.92  x 

+ 14,10  X.  + 2.19  X- 
4 5 

subject  to  the  original  constraints  (4).  As  we  shall  see  shortly  the 
results  obtained  by  continuously  changing  0 will  yield  a neo-classical 
cotton  supply  curve,  We  note  that  the  increase  in  0 causes  a decline  in 
the  net  return  per  acre  of  the  cotton  producing  process 

The  solution  with  0 = 0 is,  of  course,  the  solution  to  the  original 
problem,  which  we  already  know  to  be  the  following: 

X*  = 90,  X*  = 986,  X*  = 358,  x*  = 230,  x*  = 127, 
Remembering  that  the  positive  increase  in  0 causes  a decline  in 

it 

z^,  the  profitableness  of  producing  cotton,  V7e  realize  that  x^,  the 
optimal  acreage  of  rice  v/ill  not  change,  for  it  will  remain  the  most 
profitable  of  the  five  crops.  On  the  other  hand,  cotton  \7ill  loose  its 
position  as  the  second  ranking  crop  as  soon  as  0 becomes  large  enough. 

Until  that  point  the  values  of  the  primal  variables  will  not  change, 

(though  the  value  of  the  primal  solution  K \7ill).  The  value  of  0 that 
V7ill  make  = z^  is  easily  found  by  solving  the  equation; 


36 


or 


^2  - ® a 

65.22  - 


2 ==  "3 
0 4.00  = 


15.92 


for  0.  Thus  0 = 7Tn^'  = 12.325. 

4 . uu 

At  this  point, 

the  solution  can  be  represented  by  the  same  dual  system  of  equated 


constraints  as  when  0=0  and  the  same  primal  variable  values  as 

before.  However,  equally  good  is  the  solution  x.  = 90,  x-  = 840, 

* * * 12 

x^  = 504,  x^  = 230,  x^  = 127  and  the  dual  system  of  equated  constraints; 


(37) 


(38) 


X,  + X«  + X„  + X,  + X. 


X, 


X, 


-X, 


-X, 


1791 

90 

504 

-230 

-127 


66.67 

15.92  = 65.22  - 0 4.00 

15.92 

14.10 

2.19 

il 


As  0 is  increased  beyond  12.325  this  second  system  will  describe 
the  solution  [only  the  dual  variables  will  change  as  shovm  in  equation 
(38)]  until  0 exceeds  the  value  determined  by  the  following  equation; 


or 


- 0 4.00 


^4 

12.73. 


As  before  the  solution  at  this  point  can  be  represented  by  the 
preceding  djual  system  of  equated  constraints,  but  also  equally  well  by  the 
additional  systems. 


(39) 


X,  + X-  + X-  + x.  + X- 

1 2 3 4 5 


1791 

90 

504 

303 

-127 


and 
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(40) 


ri  +r2 


^5 


-r. 


1 ‘11 
with  the  primal  solution  variables  of 


= 66.67 

= 14,10  = 65.22  - ID  4.00 

= 15.92 

= 14.10 

= 2.19 


X*  = 90,  X*  = 767,  ^3  “ x*  = 303,  x*  = 127. 

Again  JD  is  increased  until  it  exceeds  the  value  determined  by  the 
equations 


- /)  4.00  = z^ 
or 

= 15.7575 


at  v/hich  point  the  primal  solution  is  the  same  as  before,  or  alternatively 

^ ^ Vc  ^ ^ 

and  equally  as  good — x^  = 90,  = 713,  ^3  = 504,  x^  = 303,  x^  = 181 

with  the  dual  system  of  equated  constraints: 


(41) 


Xi  +X2 

X, 


+ X-  + X,  + x> 

3 4 0 


X. 


^^4 


X. 


and 


1791 

90 

504 

803 

181 


(42) 


66,67 

2,19  = 65.22  - 0 4.00 

15.92 
14.10 
2.19. 


At  this  point  no  process  level  can  be  increased  further  at  the 
expense  of  the  cotton  process,  because  all  of  the  other  processes  are  at 
their  upper  bounds.  A further  decline  in  the  cotton  activity  therefore 
must  be  accompanied  by  allowing  some  land  to  30  idle.  But  this  can  be 
optimal  only  if  cotton  is  produced  at  a loss.  The  value  of  |D  beyond 
which  this  will  occur  is  found  by  solving  the  equation 
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^2  ” ^ 4.00  ■ 0.0 
or 

0 = 16.305. 


At  this  point  the  preceding  dual  system  of  equated  constraints  will 
describe  the  solution,  or,  equally  as  well,  the  systems 


(43) 


and 


(44) 


X 


1 


X 


3 


4 


X 


5 


= 90 

= 504 
==  303 

= 181 
= -681 


r 


1 


r 


4 


r 


5 


r 


6 


= 66.67 

= 0.00  = 65.22  - 0 4.00 

= 15.92 
= 14.10 

= 2.19 


V7ith  primal  solution  variables 


"ii  "ic  'ii  "ii  "ii 

x^  = 90,  x^  = 681,  x^  = 504,.  = 303,  = 181. 


No  further  change  can  be  made  in  the  system  of  equated  constraints 
no  matter  hov7  much  larger  0 becomes.  Therefore,  the  PLP  computations 
are  completed  and  linear  interpolation  will  produce  all  variables 
changing  with  0. 

Let  us  nov7  see  how  these  computations  can  be  transformed  to 
produce  the  cotton  supply  curve.  The  net-return  of  cotton  per  acre  (unit 
process  level)  is  computed  as  P2  y£  " = ^2  ^^here  p2  is  the  price 

of  cotton  per  cwt  lint  (we  neglect  the  value  of  cotton  seed  for  simplicity), 
the  yield  of  cotton  in  cwt/ acre,  and  C2  the  per-acre  variable  cost  of 
producing  cotton.  Now  as  we  have  let  a2,  the  change  coefficient,  be  the 
(negative  of  the)  yield  of  cotton  = -4.00)  we  could  write  this 
expression  as  p2  ^2  " ^2  ” ^2  ” ^2  " ^2“ 

As  a consequence  the  parametric  objective  function  36  could  be  written 
alternatively 
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•k 

TT  (0)  = max  66o67  + (p«  4.00  - c»  - 0 4,00)x« 

X ^ 5 O O O J X.  ^ ^ ^ 

+ 15.92  X + 14.10  X,  + 2ol9  x^ 

3 4 5 


or 

n (0)  = max  66.67  x^  + [(p«-0)  4.00  - c«]  x«  + 15.92  x_ 

+ 14.10  X,  + 2ol9  x^o 
4 5 

We  see  then  that  0 plays  the  role  of  a price  reduction  in  cotton,  so  that 
p^  - 0 is  the  parametrically  modified  cotton  price.  If  we  suppose  that 
p^  = $35.00  and  c^  = $74.78,  then  = 35.00  x 4.00  - 74.78  = 65.22  the 
original  net  return  for  cotton  (with  0=0).  Now  we  may  write  the 
parametric  objective  function  as. 


(45) 


* 


TT 


(0)  « max  66.67  x^ 
x^, . . . ,x^  1 

+ 15.92  x„  + 14.10  X 
3 4 


+ [(35.00-0)  4.00  - c^] 
+ 2.19  x^ . 


X 


2 


At  each  value  of  0 now  we  can  readily  calculate  the  corresponding  price 
of  cotton  as  $35.00  - 0,  Thus  we  have  the  following  tabulation: 


0 

P2 

0 

$35.00 

12.3250 

22.68 

12.7800 

22.22 

15.7575 

19.24 

16.3050 

18.70 

Our  results  are  now  summarized  in  Tables  5 and  6 and  in  Figure^ 

4,  5,  and  6.  Figure  4 shows  the  optimal  value  of  the  parametric  program 

as  a function  of  p^  (and  of  0) , Figure  5 shows  the  derived  supply  curv^  of 

cotton;  and  Figure  6 shows  the  values  of  several  of  the  dual  variables  as  a func 

tion  of  p„.  We  may  note  that  negative  values  of  p„  are  meaningless.  Therefore, 
^ A ^ 

we  might  have  specified  0 = 35.00,  the  value  of  0 beyond  which  the  implied 

price  of  cotton  (p^  “ 0)  becomes  negative. 
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Table  5:  Summary  of  Primal  Solutions  for  PCR  Example 


P2 

$35.00 

22.68 

22.22 

19.24 

18.70 

i) 

0.00 

12.32 

•12.78 

15.76 

16.30 

Variable 
Index  j 

z . = 

J 

p.y.-c . 
3 3 J 

* 

X. 

J 

z . = 

J 

p.y.-c. 
3 3 3 

* 

X. 

J 

z . = 

J 

p.y.-c. 
J J J 

* 
■ X. 

J 

z . = 

J 

p.y.-c. 
J J 3 

r\ 

X . 

J 

z . = 

J 

p.y.-c. 
J J-  J 

1 

i 

1 

66.67 

90 

66.67 

90 

66.67 

90 

66.67 

90 

66.67 

90 

2 

65.22 

986 

15.92 

840 

14.10 

767 

2.19 

713 

0.00 

681 

3 

15.92 

358 

15.92 

504 

15.92 

504 

15.92 

504 

15.92 

504 

4 

14.10 

230 

14.10 

230 

14.10 

303 

14.10 

303 

14.10 

303 

5 

2.19 

127 

2.19 

127 

2.19 

127 

2.19 

181 

2.19 

181 

* 

jt 

1 

•79,527, 
— - ....1  - 

.71 

30,917.91 

29,389.11 

20,254, 

.14 

18,692.67 

Table  6:  Summary  of  Dual  Solutions  for  PCR  Example 


Index 

i 

Price  p^ 

$35.00 

22.68 

22.22 

19.24 

18.70 

0 

0.00 

12,32 

12.78 

15.76 

16.30 

RHS 

Coefficients 

c . 

1 

Dual 

Variables 

* 

r . 

L 

Dual 

Variables 

r* 

1 

Dual 

Variables 

rV 

1 

Dual 

Variables 

1 

Dual 

Variables 

r? 

1 

1 

1791 

15.92 

15.92 

14.10 

2.19 

0.00 

o 

4 

90 

50.75 

50.75 

52.57 

64.48 

66.67 

3 

986 

49.30 

0.00 

0.00 

0.00 

0.00 

4 

504 

0.00 

0.00 

1.82 

13.73 

15.92 

5 

303 

0.00 

0.00 

0.00 

11.91 

14.10 

6 

181 

0.00 

0.00 

0.00 

0.00 

2.19 

7 

- 74 

0.00 

0.00 

0.00 

OoOO 

0.00 

8 

-681 

0.00 

0.00 

0,00 

0.00 

0.00 

9 

-356 

0.00 

0.00 

0.00 

0.00 

0.00 

10 

-230 

1.82 

1.82 

0.00 

0.00 

0.00 

11 

-127 

13.73 

13.73 

11.91 

0.00 

0.00 

* 

P = 

79,527.71 

30,917.91 

29,389.11 

20,254.14 

18,692.67 

Program  Value  it'  (0)  = p (0) 

$20,000  $40,000 $60,000 ^§0 , 000 
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FIGURE  4 

OPTIMAL  VALUE  OF  EXAMPLE  PROGRAM  AS  A 
FUNCTION  OF  COTTON  PRICE  (=  - 0) 
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FIGURE  5 

OPTIMAL  PROCESS  LEVELS  OF  EXAMPLE  PROBLEM  AS 
FUNCTIONS  OF  COTTON  PRICE  (=  “ 0) 
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75.00 


• • • • • • 

O to  NJ  O'  O 

o o ^ rooo  o 
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FIGUPxE  6:  0PTBIA.L  DUAL  V/VRIABLES  (M^VRGINAL  VALUES)  OF  EXAMPLE  PROGRAM  AS 

FUNCTIONS  OF  COTTON  PRICE  i ^ 
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e.  Trigger  Analysis  on  Parametric  Constraint  Matrix 

Here  the  objective  is  to  determine  the  effect  upon  the  optimal 
solution  of  changing  the  constraint  matrix  parameters  in  some  fixed 
proportions.  Let 

•••*  “im 


kl’ 


km 


be  k X m change  coefficients.  The  parametric  programming  problem  now  under 
consideration  may  be  v/ritten 


(46) 

subject  to 

(47) 


(y)  = max  (z  X + ...  + z x ) 

JL  JL  IQ  m 

L m 


(b  h^)  x^  + ...  + 


X 


• • 

< 


m 


for  all  0 = '.If  = \]r. 
In  matrix  notation 


(48) 

subject  to 

(49) 


* 


(^!^) 


T 

max  z X 


(B  + \jf  H) 


= c 


< < 

0 = \{f  = \|f 


where 


H 


^11’  •••’  *’lm 

• • 

• • 

• • 


As  i/ith.the  earlier  cases  this  problem  begins  with  >jf  = 0 and  then  changes 

in  the  solution  are  recorded  as  ifr  is  increased  continuously.  As  it 
^ *ic  ic 

increases,  x , r , and  n and  the  dual  systems  of  equated  constraints 
will  change,  as  before  in  discrete  linear  segments. 

Consider  our  familiar  example  from  Section  1,  now  augmented  with 
irhe  change  matrix  coefficients 


45 


h. - = h. *=.,.=  h,  =1.0 
11  12  Im 


12 


h.  =0.0. 
km 


For  this  case  we  have  the  problem 

5t  (y)  = max  66.67  x-  + 65,22  x + 15.92  x-  + 14.10  x,  + 2.19  x_ 

i 2 3 4 5 


Subject  to 


(l-\|r)  + ...  + (l-iir)x^ 


X, 


X, 


X, 


X, 


-X, 


-X. 


-X, 


-X, 


“X. 


= 1791 
i 90 
= 986 

= 504 

= 303 
= 181 


= - 74 

S -681 

= -356 
= -230 
= -127  . 


Although  this  example  has  no  "natural*'  economic  interpretation  as 
it  stands,  it  illustrates  the  class  of  problems  under  consideration. 
Further,  the  example  can  readily  be  shown  to  be  equivalent  to  the  PLP 
example  of  Section  4,b.  Thus,  dividing  both  sides  of  the  to?  constraint 


) 1791,  Knowing  (from  the  PLP 


by  (1  - -\Jr)  we  obtain  x^^  + , , , + x^  ^ ^ 

example)  that  there  are  four  critical  values  of  0 to  be  found  (including 
zero)  we  can  find  the  equivalent  values  of  from  the  equation 


1791  + 0.  = (t-^)  1791 
i '1  - Y 


Thus 

(50) 


0. 

X 


1791  + 0. 

1 


1 “ 1,  ...,  4, 


i = 1,  . . . , 4. 


By  substituting  the  0 values  of  Tables  3 and  4 into  the  above  expression 
the  PLP  example  could  be  transformed  to  the  Trigger  Analysis  problem  of 
this  section. 

The  conversion  of  PLP  to  Trigger  Analysis  and  vice  versa  is  a 
very  special  property  of  our  particular  examples.  In  general  they  would 
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be  quite  distinct  in  character,  IThile  this  type  of  parametric  programming 
is  of  less  general  interest,  and  certainly  much  less  widely  practiced 
than  the  others,  we  mention  it  here  for  completeness,  and  because  fcr 
certain  problems  of  economic  analysis-- such  as  the  analysis  of  changes 
in  technical  ef f iciency--it  is  of  immediate  relevance. 

It  might  also  be  mentioned  in  passing  that  one  could  consider 
parametric  LP  problems  in  which  all  three  sets  of  data  changed  as  linear 
functions  of  a single  parameter,  or  in  which  combinations  of  two  sets  of 
data  changed  as  linear  function  of  a single  parameter,  iki  exegesis  of 
these  more  general  problems  should  not  be  needed  by  the  reader.  In  any 
case  they  would  be  relevant  only  to  highly  specialized  applications. 


5.  SLACK  VARIABLES  Am  BASES 
a.  Slack  Variables  and  Disposal  Activities 

The  primal  LP  problem  can  be  transformed  into  an  alternative  form 
which  is  particularly  instructive  when  one  faces  the  problem  of  computing 
solutions  to  arbitrary  LP  problems,  lie  proceed  by  introducing  (up  to) 
k dummy  variables  y^,  and  converting  the  inequality  expressions 

2 (or  7)  into  equation  constraints.  Thus,  we  have,  instead  of  1 and  2, 
the  problem 


(51) 

subject  to 

(52) 


jt  = max  2-  X,  + , . . + z X 
11  mm 


b_  X + , . . + b-  X + y 

11  Im  m 1 


b + 

kl  1 


+ b,  X 

km  m 


+ 


= c 


1’ 


= c 


k’ 


X.  = 0,  y^ 


. > " > 

X = 0,  y = 0. 

m ic 


(Notice  that  there  are  now  k equations  in  m + k unknowns.) 
In  matrix  notation  the  converted  problem  is, 


(53) 

subject  to 

(54) 


* X 

n = max  z x 

X 


Bx  + ly  = [B,  I]  (y)  = c. 


d)  = 0. 

y 


All 
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.th 


(We  shall  in  the  sequel  refer  to  the  column  of  the  matrix  [B,  I]  as 

P..)  The  dummy  variables  y. , .0.,  y,  are  frequently  called  slack  or 
J i K “ "" 

disposal  variables.  The  columns  of  the  I matrix  appearing  in  expression 
(54)  are  frequently  called  disposal  activities. 


b.  Relation  of  Slack  Variables  to  the  "Loose”  Constraints 


The  slack  variables  indicate  the  amount  by  which  each  inequality 
constraint  is  unsatisfied  as  an  equality,  and,  in  the  case  in  which 
constraint  involves  an  economic  input,  the  amount  of  the  input  not  used  in 
the  production  process.  Thus,  if  x^,  x^  are  the  optimal  primal 

solution  variables  then 


55) 


• # 


* 

X 

m 


* * • * 
V,  = c,  - b,  -X- 

* k k kl  1 


* 

X 

m 


are  the  optimal  slack  variables. 

From  the  discussion  of  Section  3,d  and  e,  we  see  an  immediate 
correspondence  between  the  zero  or  nonzero  status  of  the  slack  variables 

and  the  "looseness”  or  "tightness"  of  a constraint.  Thus,  if  the 

* th  * 

constraint  is  tight,  y^  = 0;  if  the  i constraint  is  loose,  y.  > 0. 


c.  Optimal  Bases  and  Dual  Systems  of  Equated  Constraints 

I 

An  arbitrary  non-zero  vector  of  k dimensions,  say  c = (c^^,  ,,,,  c^) 
can  always  be  expressed  as  a linear  combination  of  k (linearly  independent) 
vectors. Thus  the  RHS  vector  c can  be  expressed  as  a linear  combination 
of  k processes  and  disposal  activities.  Such  a set  of  vectors  is  called 
a basis.  Let  P^,  . , , , be  a set  of  k such  cglumns.  Then  we  may  ^inrite 
c = Xj^  + ,,,  + x^  Pj^  or  in  vector  notation  Px  = c.  Corresponding  to 
the  optimal  solution  of  an  LP  problem  is  an  optimal  basis,  and  as  will 


^2/a  set  of  k vectors,  say  a^^,  a^^,  is  said  to  be  linearly 


independent,  if  and  only  if,  the  vector  equation  ^ 


't/he  re  K 


are  scalars,  implies 
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be  immediately  evident,  there  is  a one-to-one  correspondence  between 
optimal  bases  and  the  dual  systems  of  equated  constraints. 

Return5,ng  (as  always)  to  our  original  example,  we  find  that  the 
RHS  vector  may  be  written  as  follows: 


1791 

= 90 

‘T 

+ 986 

“1 

+ 358 

T 

+ 230 

“ 1 

+ 127 

“f 

90 

1 

0 

0 

0 

1 

906 

0 

1 

0 

0 

0 

504 

0 

0 

1 

0 

c 

303 

0 

0 

0 

1 

0 

131 

0 

0 

0 

0 

1 

- 74 

-1 

0 

0 

0 

0 

-681 

0 

-1 

0 

0 

0 

-356 

0 

0 

-1 

0 

0 

-230 

0 

0 

0 

-1 

0 

-127 

, 0^ 

Jl 

JL 

zJL 

+ 146 

~0 

+ 73 

~0 

+ 54 

+ 16 

‘”0"’ 

+ 305 

’"6“ 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

0 

0 

0 

0 

0 

1 

JU 

0 

0 

0 

0 

» 

0 

1 

0 

0 

0 

0 

0 

1 

0 

0 

0 

0 

0 

1 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

This  may  be  readily  verified  by  the  reader.  The  first  five  vectors  are 

the  columns  of  the  B matrix  that  correspond  to  the  positive  priiiial  variables 
(all  of  them  in  this  example) . The  next  six  columns  are  the  disposal 
activities  corresponding  to  the  rows  that  are  not  equated.  The  scalars 
by  which  these  vectors  are  multiplied  are  respectively  the  positive 
primal  variables  and  the  non-zero  slack  or  disposal  variables.  The 
vectors  shovm  are  the  optimal  basis. 

Our  reliable  example  has  again  illustrated  a general  principle. 

He  remember  noi-7  that 

= the  set  of  M column  Indexes  corresponding  to  the  non- zero 
primal  variables 

M2  = M - = the  set  of  M"  column  indexes  corresponding  to  the 

zero  primal  variables 
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= the  set  of  k'  rov?  indexes  corresponding  to  the  tight  primal 
constraints  (\/ith  non-zero  dual  variables) 

= K - = the  set  of  k"  rov;  indexes  corresponding  to  the 

loose  (or  linearly  dependent)  tight  constraints  (with  zero 
dual  variables) . 


The  basic  matrix  P bears  a definite  relation  to  the  equated  constraint. 

matrix  E*.  Let  us  form  the  matrix  P from  the  matrix  P by  placing  the 

rows  with  indexes  in  at  the  top  and  those  with  indexes  in  K2  at  the 

bottom.  That  is,  we  place  all  equated  constraint  rows  at  the  top  of  the 
* 

matrix.  P can  then  be  written 


M, 


P = 


p , 

p 

11 

12 

.^21 

^22 

Ki=M, 

K„ 


The  dimensions  of  these  submatrices  are  as  follov7s; 

Submatrix  Dimension 


11 

12 


22 


m’  X m* 


m‘  X k" 


X m 


k"  X k". 


The  elements  of  P, are  p. 


i e K^,  j e so  that  = B’ 


11  - 

(the  equated  constraint  matrix),  P^^^  = B",  P^^  = ^ ^ 


(56) 


P = 


»> 

m' 

k 

"b’ 

0 

I 

22  “ “k" 


m 


k*' 


IS  a 


There  are  k disposal  variables  with  indexes  K = ;1,  ...,  kj^  . 

Thus,  the  optimal  basis  is  composed  of  the  m'  vectors  P^,  i e and 

the  disposal  activities  P.,  j € K«  where  ”e"  means  “belongs  to,“  and  where 
th  ^ 

I,  is  the  j*"  column  of  the  k-dimensioned  identity  matrix  I.  The  RHS 
vectors  may  nox7  be  VTritten  as 


(57) 


j i M, 


P.  X.  + . 2 P.  y. 


c 


X7here  ",  2 “ means  summing  over  the  set  of  indexes  M,  and  similarly  for 

J e Ik  1 ^ 

2 „ ^ 

1 € 
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If  now  we  define  P to  be  a k x k matrix  comprised  of  the  vectors, 
P j > j € 3 and  , j € K2  then  \?e  have 

(53)  [ J,',  ] = c 


where  x*  is  comprised  of  elements  of  x with  indexes  in  and  y"  is  composed 
of  elements  of  y with  indexes  in  K«.  Therefore, we  have 


(59) 


X 

y" 


.“1 

0 

B"  B'*^ 

I 

It  turns  out  that  the  form  (57)  or  alternatively  (58)  is  computationa 
the  most  useful  but  (59)  shov7s  that  an  optimal  basis  is  equivalent  to  a 
nonsingular  dual  system  of  equated  constraints. 


d.  A Remark  in  the  Simplex  Method 

The  art  of  computing  solutions  to  LP  problem  is  a highly  developed 
branch  of  applied  mathematics.  From  the  economists  point  of  view,  it  is 
not  of  crucial  interest,  for--as  we  have  seen--the  theory  (and  economic 
sense)  of  linear  programming  can  be  understood  without  any  knox^ledge  of 
it.  And  it  has  been  possible  to  illustrate  the  theory  with  a model  so 
simple  that  a computation  method  is  intuitively  obvious.  IJhile  the 
solution  of  general  LP  problem  of  any  size  is  far  from  obvious,  it 
really  need  not  concern  the  user  of  USDA  LP/90.  The  latter  has  been 
designed  by  specialists  and  it  has  been  thoroughly  tested  in  a great 
variety  of  problems.  All  X7e  need  is  a sufficient  understanding  of  our 
o\m  L?  problem  to  properly  prepare  the  data  and  to  interpret  LP/90 's 
output.  V7e  can  always  check  the  solution  to  make  sure  that  the  program 
has  done  its  job;  that  we  know  how  to  do  from  the  theorems  of  Section  3.b. 

There  is  an  additional  reason  for  omitting  a detailed  discussion 
of  computation  technique,  and  that  is  simply  because  there  are  many 
excellent  discussions  of  it  readily  available.  However,  before  passing 
to  other  subjects  we  may  make  one  or  two  comments  that  will  relate  the 
best  known  computation  procedure  to  the  discussion  so  far.  The  latter  is 
the  justly  famous  simplex  method  and  its  variants. 
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This  method  is  comprised  of  two  parts:  first,  that  of  finding  a 

feasible  solution  and  second,  that  of  finding  an  optimal  solution.  It 
proceeds  by  finding  a basis,  such  that 


. 2 


o o „ 

P.  X.  + . 2 


o _ o 
P.  y.  = P 


j € 'j  "j  ■ j € 3 ' 3 

\/here  P is  set  equal  to  c and  such  that  x?,  y?  > 0 for  all  j in  M,  and 
o ^ j’  o 1 

K«  respectively.  This  is  a feasible  solution  and  the  P.  columns  are  the 
2 3 

corresponding  feasible  basis.  Next  the  method  proceeds  to  find  basis 

after  basis 


p°  p^ 


i.  til 

where  P is  the  matrix  of  basis  vectors  in  the  i basis,  until  the 

optimal  basis  is  reached.  The  procedure  by  which  a given  basis  is 

derived  from  the  proceeding  basis  leads  to  feasible  solutions  with 

successively  larger  values  of  the  program  value  (ir  ) , until,  after  a 

finite  number  of  computations,  the  optimal  basis  is  found.  Each  successive 

basis  is  obtained  by  dropping  one  of  the  columns  already  in  the  basis ' 

and  replacing  it  v;ith  one  not  previously  in  it.  The  simplex  and  related 

methods  are  techniques  for  choosing  efficiently  the  vectors  to  be  dropped 

from  and  added  to  the  basis  and  for  inverting  the  resulting  basis  matrix 

to  obtain  the  successive  feasible  solution  vectors. 


6.  RECURSIVE  LINEAR  PROGRAMMING  (RLP) 
a.  The  Basic  Idea 

Recursive  linear  programming  (RLP)  is  a sequence  of  LP  problems' 
in  which  the  objective  function,  constraint  matrix,  and/or  the  right  hand 
side  parameters  depend  upon  the  primal  and/or  dual  solution  variables  of 
the  preceding  LP  problem  (or  problems)  in  the  sequence.  In  current 
agricultural  applications[l,  2, 3, 10 ], each  problem  in  the  sequence  is 
associated  with  a given  production  year,  and  its  solution  is  interpreted 
as  a "prediction”  (or  explanation)  of  the  given  years*  expected  production, 
income,  costs  and  input  utilization.  Consequently,  the  model  describes 
how  current  plans  are  related  to  past  expectations  and  performance.  In 
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addition  to  a dependence  on  preceding  LP  solutions,  the  current  problem 
data  may  depend  on  various  exogenous  or  predetermined  variables.  One 
might  summarize  the  meaning  of  this  class  of  models  as  the  description 
of  optimizing  over  a limited  time  horizon  on  the  basis  of  knowledge 
gained  from  past  experience.  They  express  the  manner  in  which  economic 
plans  are  reformulated  as  each  period *s  experience  is  accumulated. 

Formulated  with  this  degree  of  generality  RLP  is  a bit  clumsy  to 
express  mathematically.  Instead  in  what  follows  we  shall  describe  several 
special  cases  of  RLP, 


b.  Type  I RLP:  Recursive  PUS,  Diagonal  Primal  Dependence 
This  model  can  be  expressed  as  follows 
(60)  /(t)  = 

subject  to 

'’ll  '’im  ’'m  ‘’l 

b 


• Q 

• # 

• • 


vrhere 


(62) 


(U)  + ...  +b^x^  (t)  (t) 


^l  (t)  = x*(t-l)  + ...  + x*(t-l)]  + (t) 

• • 

• • 

» • 

\ \l  ^ ^ '’km  ^ “k 


where  u^(t),  ...,  "exogenous"  variables  (i.e.,  are  not  recursively 

generated).  In  matrix  notation, 

(63)  jr*  (t)  = max  z (t)^  x (t) 

X (t) 

subject  to 


(64)  Bx(t)  = c(t) 


v/here 
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(65) 


c(u)  =r  Bx"'(t-l)  + u(t) , 


\vhere  u(t)  = [u^(t),  u^(t)]  , where  z(t)  = [z^(t), 

finally  where 


V 

Relation  (64)  and  (65)  can  be  recombined  to  show  more  clearly  the 
recursive  structure,  thus 


(64*) 


B3?(t)  i r Bx*(t~l)  + u(t) 


The  objective  function  parameters  z^(t)  have  the  "hat*'  to  indicate 
that  they  involve  expected  net  returns  (gross  profits)  rather  than  realized 
gross  profits.  From  the  econometric  point  of  view  it  is  convenient  (and 
often  a close  representation  of  actual  fact)  to  represent  these  variables 
as  dependent  entirely  upon  their  past  values.  Thus,  for  example,  we 
might  have 

(66)  z(t)  = \ z(t-l)  + z(t-2)  + ,,,  + z(t-h) 


where 

(63') 


h 

iil 


The  simplest  example  of  such  a net-return  expectation  model  is  v/hen 

/N 

X = 1 and  h = 1.  Then,  z(t)  = z(t-l).  This  is  in  fact  the  case  that  has 
been  studied  to  date.  However,  current  research  includes  the  study  of 
models  vzith  h = 3.  In  general,  we  could  write  the  case  under  consideration; 
using  (64*)  and  (66)  as 


n (t)  = max 
x(t) 


r ^ 


X^  z(t-i)]^  x(t) 


subject  to 


(64*) 


Bx(t)  S r Bx*(t-1)  + u(t)  . 


Diagonality  of  P explains  the  name  for  this  case.  While  the  z(t)  vector 
depends  recursively  on  past  (realized)  values  of  net-returns,  they  are 
exogenously  determined  (and  predetermined)  the  sense  that  they  do 
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not  depend  on  the  lagged  values  of  the  solution  variables  x (t)  and  r (t). 

In  addition  to  these  predetermined  variables  the  u(t)  vectors  exert  an 
exogenous  influence  on  the  RHS  elements.  In  some  cases  the  7^  may  equal 
zero  in  which  case  the  corresponding  RHS  element  would  be  determined  in  a 
completely  exogenous  manner. 

We  must  now  inquire  as  to  how  such  a model  may  be  started  up.  The 
ansx^er  is,  of  course,  the  same  as  for  other  classes  of  dynamic  models. 

One  finds  initial  conditions  from  which  a given  year*s  data  can  be 
derived,  and  from  which  succeeding  solutions  may  proceed.  There  are  two 
alternative  forms  in  which  the  initial  data  for  the  case  being  studied 
may  be  cast,  depending  on  whether  one  uses  the  form  (63),  (64),  (65)  or, 
alternatively,  (63’),  (64*).  We  shall  assume  that--either  way — z (t)  is 
obtained  from  (66) , 

Consider  the  first  form:  for  some  base  year  (say  for  t = 1) 

we  must  know  (or  have  estimates  of)  c(l),  z(0),  z(-l),  ...,  z(l-h).  Then 

•k 

the  first  LP  problem  in  the  sequence  can  be  solved,  giving  x (1) 

= Lx-(l),  X (1)]  , Then  this  last  solution  vector  can  be  plugged 

i m 

in  the  expression  (65),  giving  the  RHS  for  the  next  year,  t = 2.  This 

process  is  repeated  as  long  as  one  has  data  for  z(t)  and  u(t) 

T 

= [uj^(t),  .,,,  u^(t)]  . The  latter  (as  noted  already)  are  values  v/hich 

do  not  depend  on  the  preceding  year’s  solution. 

In  the  second  form  we  again  need  to  know  or  have  estimates  of 

2(0),  z(-l),  z(l-h),  but  now,  instead  of  c(l)  we  presuppose  a 

* 

knowledge  (or  estimate)  of  x (0),  that  is,  an  initial  vector  of  process  levels. 
Using  (66)  the  former  data  give  z(l).  By  plugging  the  latter  into  (62) 

[or  alternatively  (65)  or  (64’)],  gives  c(l)  so  that  x (1)  may  be  obtained 
as  the  solution  to  the  resulting  LP  problem.  Now  this  vector  may  be 
inserted  into  (62)  or  (65)  again,  giving  the  RHS  for  period  2,  c(2),  and 
so  on,  until  the  exogenous  information  is  exhausted. 


c.  An  Example  of  Type  I RLP:  Process  and  Flexibility  Adjustment 

The  tried  and  true  example  with  which  the  illustrations  of  LP 
began  can  be  readily  generalized  to  serve  as  an  example  of  Type  I RLP’. 
Elsewhere,  that  simple  model  has  been  referred  to  as  the  Henderson  Model 
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and  its  generalization  to  Type  I RLP,  as  the  Dynamic  Henderson  Model  [2  1. 

Table  7 contains  the  initial  conditions  and  the  r.  coefficients  while 

1 

Table  8 contains  the  objective  function  variables.  Finally  we  assume  that 
c(l)  = ,t.  = c(6)  = 1761c  That  is,  we  assume  the  supply  of  land  remains 
constant  throughout. 

Using  a notation  analogous  to  that  of  Section  l.b  the  model  may 
be  written 


(67)  /(t)  = (t)  x^(t)  + ...  +35(6-1)  X5(t) 


t •“  1,  •••)  6, 


(68) 


Xj(t)  + X^(t)  + x^(t)  + x^(t)  + x^(t) 
X^(t) 

X2<t) 

X3(t) 

X4«:) 

X3(t) 

-X2(t) 

-X2(t) 

-X3(t) 

-X4(t) 

-X5(t) 


= 1791 

i 1.13  K*(t-1) 

= 1.13  x*(t-l) 

< * 

= 1.20  x^(t-l) 

= 1.16  x*(t-l) 

= 1.20  x*(t~l) 

K.  "k 

= -,92  x^(t-l) 

1 -.78  x*(t-l) 

K k 

=s  -.84  x^(t-l) 

^ k 

= -.87  x^(t-l) 

= -.84  X5(t-1). 


Now  under  the  assumption  that  x^e  know  c(l),  as  shoxim  in  Table  7, 
and  using  z(0)  from  Table  8 x-ze  have  an  LP  problem  exactly  the  same  as 
that  in  Section  l.b  with  exactly  the  same  solution.  That  solution  (nox; 
augmenting  it  with  the  time  variable)  is 

X*  (1)  = 90 

X*  (1)  = 986 

X*  (1)  = 353 

X*  (1)  = 230 

X*  (1)  « 127. 
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Table  7:  Additional  Parameters  for  Type  I RLP  Example 


Row 

Index 

n 

Gamma 

Coefficients  (7.) 

RHS 

Coefficients 

c.(0) 

1 

0 

1791 

2 

1.30 

90 

3 

1,13 

986 

4 

1.20 

504 

5 

1.16 

303 

6 

1.20 

181 

7 

.92 

- 74 

8 

,78 

-681 

9 

.84 

-356 

10 

.87 

-230 

11 

.84 

-127 

Table  8:  Objective  Function  Coefficients  for  Type  I RLP  Example 


Year 

2l(t) 

z^(t) 

0 

66.67 

65.22 

15.92 

14.10 

2.19 

1 

64.00 

68.00 

13.00 

15.00 

4.00 

2 

63.00 

69,00 

12.00 

16.00 

6.00 

3 

65.00 

66.00 

14.00 

15.00 

5.00 

4 

68.00 

64.00 

16.00 

14.00 

3.00 

5 

69.00 

63.00 

' 17.00 

13.00 

2.00 
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Plugging  these  values  into  the  right  hand  part  of  (68)  we  find  c(2). 

This  gives  the  right  hand  side  shown  in  Table  9 from  which  the  new  LP 
solution  X (2)  is  derived.  The  latter,  shown  in  Table  10,  is  derived  in 
the  same  manner  as  in  all  the  preceding  examples,  because,  for- a given 
year,  the  model  is  an  LP  problem  of  exactly  the  same  kind.  Table  9 gives 
the  recursively  generated  RHS*s  and  Table  10  the  primal  solution  variables 
for  t = 1,  6.  Notice  that  because  the  exogenous  net-return  information 

Table  8)  is  available  only  up  to  t = 5,  the  model  can  be  solved  only  up 
to  t = 6,  In  short,  the  model  under  consideration  is  a one  year  forecaster. 
Figure  7 represents  the  progress  of  the  primal  variables  through 

time. 


d.  Ty^e  7.1  RLP:  Recursive  RHS,  Linear  Primal  Dependence 

This  model  differs  from  its  Type  I relative  in  tx*7o  regards, 
first,  the  RHS  dependence  on  the  preceding  primal  solution  is  a general 
linear  transformation;  second,  the  linear  dependence  is  extended  to  the 
slack  variables.  Relations  (60)  and  (61)  are  still  applicable  but  should 
be  rexTritten  as 


Ci<t)  = X*  (t-l)  + ...  + (t-1)  + y*  (t-1)  + 


(69) 


+ 0 


lm,m+k 


= ^kl  \ ^ ^km  ^ ^k,m+l  h (t-1)  + ••• 

* 


* \,m+k  ^k  ^ “k 


* 


Here,  y^^  (t-1),  ...,  (t-1)  are  the  values  of  the  proceeding  year's  ^ 

optimal  slack  variables.  If  we  recall  that 


y*(t)  = c^(t)  - x*(t)  + ...  + X*  (t)] 

% 

y^(t)  = c^(t)  - x*(t)  + ...  + X*  (t)] 


then  (69  ) can  be  re- expressed  as 
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+ ...  + * •••  * 

• • 

'*'  °k,m+k'^k^*^‘^^ 
k 

where  a..  =0,.  - .2.,  jD.  b.. 

ij  0.J  1=1  i,m+l  ij 


and  where  a.  . = 0. 

i,m+j  x,m+j 


1 “ ly  • t • ) k, 
1 

j ~ •••;»  ^ 

i = 1,  , , i 
j ~ I5  •>•<>}  k* 


In  matrix  notation  (69)  can  be  reduced  tc  the  following 


(71)  c(t)  = 

= 0’  x*(t-l)  + <] 

y (t-1)  + u(t) 

when  0 = 

^11’  ^Im 

and  = 

• • 

• tt 

Kv  ^Icnr 

• • 

*^k,m+l’  ®k,m+k 

and  (70)  to 


(72)  c(t)  = a x*(t-l)  + 0"  c(t-l)  + u(t) 


where 

(73)  -<[)••  B = 


• « • 


-“kl’  *••’  °'kl- 


As  in  the  Type  I case,  the  objective  function  for  T3rpe  II  models 
would  ordinarily  be  derived  from  an  expression  like  (66), 


e.  An  Example  of  Type  II  RLP;  Investment  and  Depreciation 

The  significance  of  Type  II  RLP  can  be  best  illustrated  by  a simple 
investment  model  extracted  from  our  familiar  example  in  its  original 
form.  Let  us  retain  the  first,  overall  land  restriction  and  the  five 
upper  bounds  on  each  crop.  Instead  of  interpreting  these  upper  bounds 
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Table  9;  Recursively  Generated  Right  Hand  Sides  for  Type  I RLP  Example 


Row 

Index 

i 

c,(l) 

c.(2)** 

c^(3)** 

0,(4) 

** 

0,(5) 

** 

c.(6) 

1 

1791 

1791 

1791 

1791 

1791 

1791 

2 

90 

117 

108 

99 

91 

118 

3 

986 

1114 

1245 

1357 

1451 

1502 

4 

504 

605 

359 

300 

252 

211 

5 

303 

351 

323 

202 

175 

152 

6 

181 

217 

128 

108 

91 

77 

7 

- 74 

- 83 

- 76 

- 70 

- 64 

- 84 

8 

-681 

-779 

-860 

-937 

-1001 

-1037 

9 

-356 

-299 

-250 

-210 

-176 

-148 

10 

-230 

-200 

-174 

-151 

-131 

-114 

11 

-127 

-107 

- 90 

- 76 

- 64 

- 54 

Note  that  this  column  gives  the  initial  conditions. 
RHS  elements  rounded  to  nearest  integer. 


Table  10:  Primal  Solutions  for  Type  I RLP  Example 


Year  (t) 

X*(t) 

4(t) 

x*(t) 

rt 

* 

X5(t) 

1 

90 

986 

358 

230 

127 

2 

83 

1102 

299 

200 

107 

3 

76 

1201 

250 

174 

90 

'4 

70 

1284 

210 

151 

76 

5 

91 

1329 

176 

131 

64 

6 

118 

1357 

148 

114 

54 

Acreage 


60 


FIGURE  7:  TYPE  I RLP  EXAMPLE:  PROGRESS  OF  THE  PRD4AL  VARLYBLES 

THROUGH  TIME 
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as  flexibility  constraints,  let  us  consider  them  to  be  capacity  con- 
straints, so  that  c^Ct)  is  capacity  In  acres  of  producing  rice,  c^(t) 

is  capacity  in  acres  of  producing  corn.  Let  us  not  worry  in  this 
exercise  about  the  problem  of  defining  and  measuring  capacity,  and 
further  let  us  drop  the  remaining  five  "lower"  flexible  constraints. 
Finally,  let  us  set  s^(t)  = z^(t-l),  z^(t)  = z^Ct-l),  i.e.,  the 

expected  net  return  coefficient  eqiial  to  lagged  net  returns,  and  use  as 
data  the  items  shown  in  Table  8.  With  this  treatment  our  objective 
function  is  the  same  as  (67), 


Table  11:  PHI  Coefficients  for  Type  II  RLP  Example 


5+i 


Our  model,  written  out  in  full  is 

max  z^  (t-1)  Xj^(t)  + ...  + Z^(t-l)  x^(t) 

subject  to 


+ X^(t)  + XjCt)  + X^(t)  + Xj(e) 

< 

1791 

< 

^»2ix*(t-l) 

< 

l&32X*(t-l) 

+ ^3772 (t-i) 

X3(t) 

< 

0^3X3 (t-i) 

< 

^54*4 

+ 05gy*(t-l) 

X^(t) 

< 

^6,10y^‘^- 

Using  the  data  of  Table  11,  the  constraints  are  as  follows  [expressed  in 
the  form  (72)] . 
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(74) 


x^(t)  + ... 
x^(t)  = 

X2<t)  S 

XjCt)  = 

= 

X5<t)  S 


X (t)  i 1791 
.5  x*(t-l)  + 
.2  x*(t-l)  + 
.5  x*(t-l)  + 
.5  x*(t-l)  + 
.2  x*(t-l)  + 


.9  c^(t-l) 
.9  c^Ct-l) 
.9  C3(t-1) 
.9  c^(t-l) 
.9  C3(t.l) 


These  constraints  state,  in  turn,  (i)  the  total  amount  of  land  used  in 
any  year  must  be  less  than  1791  acres,  the  total  available,  (ii)  the 
capacity  used  of  rice  (in  acres)  cannot  be  greater  than  a 50%  increase 
over  that  actually  utilized  the  preceding  year  plus  ninety  per  cent  of 
the  preceding  year’s  capacity,  and  so  on.  We  are  saying,  that  new 
inve stment  is  related  to  the  actual  amount  of  capacity  used  the  preceding 
year,  plus  the  amount  of  capacity  available  the  preceding  year  allov;ing 
for  10%  depreciation.  The  coefficient  in  the  first  column  of  Table  11 
thus  gives  a gross  irwes^ment  coefficient,  V7hile  that  in  the  second 
column  gives  ope  minus  a depreciation  coefficient  (the  latter  being  10%) . 
In  the  matrix  form  of  relation  (72)  we  would  have 


1 

1 

1 

1 

1*“ 

» 

a = 

0 

0 

0 

0 

o'" 

1 

0 

0 

0 

0 

.5 

0 

0 

0 

0 

0 

1 

0 

0 

0 

0 

.2 

0 

0 

0 

0 

0 

1 

0 

0 

0 

0 

.5 

0 

0 

0 

0 

0 

1 

0 

0 

0 

0 

.5 

0 

_ 0 

0 

0 

0 

1_ 

0 

0 

0 

0 

.2 

0 

0 

0 

0 

0~ 

> 

u(t)  = 

“’l79i 

.9 

0 

0 

0 

0 

0 

0 

.9 

0 

0 

0 

0 

0 

0 

.9 

0 

0 

0 

0 

0 

0 

.9 

0 

0 

0 

0 

0 

0 

.9 

0 

and,  noting  that  from  (73),  we  have  = 0 + 0”  B,  then 


0*  = 


0 

1,4 

0 

0 

0 

0 


0 

0 

1.1 

0 

0 

0 


0 0 0 

0 0 0 

0 0 0 

1.4  0 0 

0 1.4  0 

0 0 1.1 


and  0",  B,  and  u(t)  are  as  shown  for  the  relation  (72)  version  of  the  constraint 
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Let  us  suppose  that  we  start  with  Initial  Condition  as  follows 


c(0) 


i79r 


90i 

986j 


181! 
I—  — 


x"^(0) 


90 

986 

358 

230 

127 


Using  the  right  side  of  the  relation  in  (74)  we  find  that 


c^(l)  = 1791 


CjCl)  = .5 

(90) 

+ .9 

(90)  = 126 

03(1)  = .2 

(986) 

+ .9 

(986)  = 1085 

c^(l)  = .5 

(358) 

+ ,9 

(504)  = 633 

Cjd)  = .5 

(230) 

+ .9 

(303)  = 388 

c.(l)  = .2 

(127) 

+ .9 

(181)  * 188 

Using  z(l)  = z(0)  from  Table  8 as  the  objective  function  we  nov?  obtain 
the  optimal  solution 

x*(l)  = 126 

x*(l)  = 1085 

x*(l)  = 580 

x*(X)  = 0 

x*(l)  = 0. 

Next  we  find  that 

c^(2)  = 1791 

0^(2)  = .5  (126)  + .9  (126)  = 176 

c^(2)  = .2(1005)  + .9  (1085)  = 1194 

c^(2)  = .5  (580)  + .9  (633)  = 850 

C3(2)  = .5  (0)  + .9  (388)  = 349 

c^(2)  = .2  (0)  + .9  (188)  = 169 


so  that  using  z(2)  = z(l)  as  the  objective  function  we  get 
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x*(2)  = 176 

X2(2)  = 1194 

X3(2)  = 72 

x*(2)  = 349 

^5(2)  = 0. 

In  a similar  way  v/e  find  the  solutions  for  the  years  t ==  3,  4,  5 and  5, 
These  are  summarized  in  Tables  12  and  13,  and  the  primal  variables  are 
plotted  in  figure  8. 

Table  12:  RHS  or  Capacity  Coefficients  for  Type  II  RLP  Example 


Variable 

Year  (t) 

1 

2 1 

! 

3 1 

. ..  ,| 

4 

5 

6 

0 

h-* 

rt 

1791 

1791 

1791 

1791 

1791 

1791 

c^Ct) 

126 

176 

264 

370 

507 

710 

CjCt) 

1085 

1194 

1313 

14^f4 

1588 

1558 

633 

860 

810 

729 

656 

589 

C3(t) 

388 

349 

489 

547 

492 

443 

Cg(t) 

188 

169 

152 

137 

123 

111 

Table  13: 

Optimal  Primal  Solutions  for  Type  II  RLP  Example 

rt 

126 

176 

264 

347 

507 

710 

X2(t) 

1085 

1194 

1313 

1444 

1284 

1081 

X3<t) 

580 

72 

0 

0 

0 

0 

x^(t) 

0 

349 

214 

0 

0 

0 

(t) 

0 

0 

0 

0 

0 

0 

The  attentive  reader  will  notice  that  while  this  particular 
model  describes  capacity  in  a reasonably  satisfactory  way  when  capacity 
is  either  fully  utilized,  or--at  the  other  extreme--not  utilized  ^t  all. 
It  does  not  appear  satisfactory  in  the  positive  but  underutilized  case, 

A moment's  reflection  will  lay  the  cause  to  the  purely  linear  dependence 
of  investment  and  depreciate  on  the  actual  and  potential  capacity 
utilization  of  the  preceding  year. 


2000 

1500 

1000 

500 
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Cotton, 


Year 


FIGURE  8:  TYPE  II  RLP  EXAMPLE:  PROGRESS  OF  PRIM^iL 

VARIABLES  THROUGH  TIME 
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The  resolution  of  this  difficulty  cannot  be  taken  up  here.  More 
general  RLP  models  could  be  invoked  for  the  purpose  but  that  V7ould  carry 
us  far  into  the  theory  of  investment  and  dynamic  economic  models  and 
beyond  our  immediate  purpose  of  illustrating  a particular  type  of  RLP. 


f.  Type  III  RLP;  Recursive  RHS,  Linear  Dual  Dependence 


Here  v;e  shall  let  the  recursive  generation  of  the  RHS  vector 
depend  on  the  dual  variables  as  well  as  the  lagged  RHS  vector.  Thus, 


(75) 


Ci(t)  - r^(t-l)  + ...  + ^i,k+l 


+ a 


i,2k 


or  in  matrix  notation 


(76)  c(t)  = r''(t-l)  + c(t-l)  + u(t). 

By  recalling  that  Bx  (t)  + y (t)  = c(t),  the  model  can  be  written  as  a 
relation  betv;een  the  current  RHS  and  the  lagged  primal  solution  and 
slack  vector,  i.e,, 


(77) 


c(t)  = r"^(t-l)  + Bx*(t-1)  + y (t-1)  + u(t). 


This  model  will  enable  us  to  express  investment  in  specific  quasi  fixed 
factors  as  function  of  the  mar?;inal  value  productivities  or  quasi-rents. 


g.  Example  of  Type  III  RLP:  More  on  Investment  and  Depreciation 


Under  certain  highly  restrictive  assumptions  which  suit  our 
present  needs,  the  ^present*’  value  of  a capital  good  may  be  expressed  as 


V = 


r 

K+d 


where  K is  the  intex*est  rate,  d an  uncertainty  discount  factor  and  r the 
quasi-rent.  Let  these  values  be  subscripted  so  that  the  terms 





* 

^2(t), 


K+d, 


* 

r,.(t) 
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give  the  capital  values  of  each  fixed  factor  based  on  current  quasi- 
rents. If  v/e  let  investment  depend  on  lagged  capital  values  of  marginal 
increments,  we  might  write  for  our  last  investment  model. 


(78) 


V7here  the  first  term  measures  gross  investment  and  the  second  term 
measures  previous  capital  stock  less  depreciation.  These  terms  are 
linear  in  the  model  variables If  we  suppose  that  the  interest  rate 
K and  the  prices  of  capital  goods  are  reasonably  constant  over  time  \re 
may  proceed.  The  last  expressions  are  already  in  the  form  (75)  and  can 
be  placed  in  the  form  (76)  by  letting 


"1  = 

""  0 

0 

0 

0 

0 

0~ 

. s = 

*"  0 

0 

0 

0 

0 

0 

0 

^2 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

^3 

0 

0 

0 

0 

0 

s 

0 

0 

0 

- 

0 

0 

0 

0 

0 

0 

0 

0 

“10 

0 

0 

0 

0 

0 

0 

^5 

0 

0 

0 

0 

0 

11 

0 

0 

0 

0 

0 

0 

^6 

0 

0 

0 

0 

0 

"12- 

and 


u(t)  = 


where 


P/  Mi  i»  ^ 

""i  “ K+d. 


x~*2,  ...,  6 


a.  = 1-5.  , 
1 1-6 


i = 8 , . . . , 12 


Let  us  suppose--as  before — thatb^  = ...  ^5  “ «^lso,  let  us  suppose 

that  K=  .05  and  p = ,,,  = g = ,25  and  that  the  uncertainty  discount 

2 o 

factors  may  be  written 


Capacity 

Discount  Coefficient 

Investment  Coefficient 

Rice 

.15 

2.50 

Cotton 

.15 

1.25 

Soybeans 

.20 

1.00 

Oats 

.05 

2,50 

Corn 

.20 

1.00 
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RevTriting  (78)  with  these  data  v;e  have 

c^Ct)  = 2.50  r^Ct-l)  + .9  c^(t-l) 

c^Ct)  = 1.25  r^Ct-l)  + .9  c^Ct-l) 

(78')  c^(t)  = 1,00  r*(t-l)  + .9  c^^(t-l) 

c^(t)  = 2.50  r*(t-l)  + .9  c^(t-l) 

c^(t)  = 1.00  r*(t-l)  + .9  c^(t-l). 

Let  us  now  use  the  same  lagged  objective  function  values  as  before 

(Table  8)  and  use  as  initial  conditions  z(0)  and  c(l)  with 

c^(l)  = 1791 

c^d)  = 90 

c^(l)  = 936 

c^(l)  = 504 

c^(l)  = 303 

c^(l)  = 181. 

The  primal  solution  is 

x*(l)  = 90 

x*(l)  = 936 

x^(l)  = 504 

x*(l)  = 211 

xjd)  = 0 

and  the  positive  dual  variables  are 
r*(l)  = 14.10 

r*(l)  = 52.57 

r*(l)  = 51.12 

r*(l)  = 1.82. 

Then,  using  (78 ‘)  we  find  that 
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C;l(2)  = 

1791 

C2(2)  = 

212 

C3(2)  = 

941 

‘=4(2)  = 

456 

05(2)  = 

273 

0 

' — ' 
It 

163. 

Using  objective  function  z(l)  we  find  that 


x*(2)  = 

212 

* 

= 

13.00 

* 

^2(2)  = 

941 

r2(2)  = 

51.00 

JU 

X3(2)  = 

365 

r;(2)  = 

55.00 

<(2)  = 

273 

r5(2)  = 

2.00 

X5(2)  = 

0 

In  a similar  manner  we  find  the  remaining  solutions  included  in  Tables 
14  and  15,  the  primal  variables  of  which  are  charted  in  Figure  9. 


Table  14:  Recursive  RHS  Vectors  and  Optimal  Dual  Variables  For  RLP 

III  Example 


Year 

Constant 

* 

1 

2 

3 

c(l) 

* 

r (1) 

c'(2) 

r*(2) 

c(3) 

r*(3) 

1 

1791 

14.10 

1791 

13.00 

1791 

12.00 

2 

90 

52.57 

212 

51.00 

309 

51.00 

3 

986 

51.12 

941 

55.00 

916 

57.00 

4 

504 

1.82 

456 

0 

410 

0 

5 

303 

0 

273 

2.00 

246 

0 

0 

6 

181 

0 

163 

0 

147 

0 

i 

Year 

4 

5 

6 

•3^ 

Constant 

c(4) 

r''(4) 

c(5) 

r*(5) 

c(6) 

r’^CO) 

1 

1791 

14.00 

1791 

14.00 

1791 

13.00 

2 

406 

51.00 

493 

54.00 

579 

56.00 

3 

895 

52.00 

871 

50.00 

846 

50.00 

4 

369 

0 

332 

0 

299 

4.00 

5 

231 

1.00 

211 

2.00 

195 

6 

132 

0 

119 

0 

107 

This  is  the  initial  condition  year  where  c(l)  is  assumed  known. 
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TYPE  III  RIP  EXiUIPLE:  PROGRESS  OF  PRIMAL  VARIABLES  THROUGH  TIME 


Table  15:  Optimal  Process  Levels  for  Type  III  RLP  Example 


71 


Varia' 


Year  (t) 


ble 


x/(t) 

xLt) 

x^(t) 


•k 

1 

2 

3 

4 

5 

6 

90 

212 

309 

406 

493 

579 

986 

941 

916 

895 

871 

846 

504 

365 

320 

259 

332 

299 

211 

273 

246 

231 

95 

67 

0 

0 

0 

0 

0 

0 

Initial  condition  year. 


h.  Other  Kinds  of  RLP 

More  and  more  general  RLP  models  can  be  constructed,  but,  as  our 
discussion  has  already  (in  the  last  case)  carried  us  beyond  the  current 
computing  capacity  of  USDA  LP/90,  further  elaboration  is  left  to  the 
reader.  It  is  perhaps  useful  only  to  remark  in  this  place  on  one  or  two 
RLP  types  that  have  yet  to  be  explored  but  that  appear  to  hold  much 
promise . 

Ever  since  Hicks*  justly  famous  masterpiece  Value  and  Capital 
appeared  (1938)  economists  have  been  concerned  with  optimal  planning 
over  time.  The  field  of  dynamic  programming  is  the  class  of  mathematical 
methods  devoted  to  this  problem.  It  is  quite  possible  that  RLP  models 
should  be  structured  to  account  for  planning  over  time.  This  would  be 
done  by  including  future  time  periods*  (as  well  as  present)  activities 
and  constraints.  Such  dynamic  linear  programming  models  could  still  be 
imbedded  in  a recursive  structure  like  those  presented  here.  This  idea 
has  been  sketched  out  elsewhere  [ 2 , 3]. 

Another  area  begging  for  RLP  treatment  would  seem  to  be  that  of 
spatial  competition.  The  so-called  spatial  competition  models  presently 
available  for  agriculture  suggest  adjustment  goals,  but  not  rates  of 
adjustment  toward  them,  Without  the  latter,  who  knows  if  the  so-called 
normative  goals  can  be  reached?  In  this  field  tv/o  types  of  recursiveness 
need  to  be  built  in,  (1)  adjustment  in  capacity — more  or  less  like  the 
models  illustrated  above — and  (2)  the  dependence  of  actual  prices  on 
aggregate  outputs  and  hence  the  dependence  of  expected  prices  on 
aggregate  outputs.  The  latter  type  of  structuring  introduces  a different 
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kind  of  RLP,  namely  Recursive  Objective  Function,  in  which  the  coefficients 
of  the  latter  would  depend  (through  demand  functions)  on  linear  combinations 
of  the  lagged  optimal  process  levels. 

It  is  hoped  that  future  analysis  will  include  work  along  both  of 
the  above  lines. 


PART  III:  THE  DESIGN  AND  USE  OP  LP/90 

1.  PHILOSOPHY 
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a.  The  Need  for  a General  System 

Agricultural  economist s«  like  other  practitioners  of  linear 
programming,  construct  LP  models  that  commonly  call  for  a variety  of 
closely  related  computations.  A researcher  may  wish  to  maximize 
several  different  objective  functions,  each  of  v/hose  variables  are 
subject  to  identical  constraints.  The  solutions  to  a number  of  quite 
independent  problems  may  be  needed.  Parametric  programmins  (price  or 
resource  mapping)  on  several  different  basic  solutions  may  be  desired. 

In  addition  to  the  many  LP  and  LP- related  computations  currently 
in  use,  model  builders  continually  find  new  applications  of  LP  models 
which  require  quite  new  computations,  either  for  setting  up  an  LP 
problem,  analyzing  its  solution,  or  modifying  a basic  model.  Sometimes 
the  work  required  merely  to  set  up  the  initial  LP  matrix  is  so  taxing 
in  itself,  that  a method  of  computing  it  from  more  basic  data  is 
desirable.  At  the  other  end  of  the  spectrum,  the  work  of  analyzing  a 
number  of  related  or  independent  LP  solutions  may  be  so  burdensome  that 
some  method  of  automatically  performing  the  analysis  and  preparing 
final  tables  is  required  to  make  a study  feasible. 

The  extent  and  variety  of  these  related  computations  may  reduce 
the  solution  of  a single  linear  programming  problem  to  a minor  portion 
of  the  total  job  to  be  done*  For  this  reason  a working  system  that  can 
accoomodate  a great  variety  of  needs  is  a powerful  asset  to  the  user. 
Flexibility  and  generality  of  this  kind  has  been  the  goal  in  the 
development  of  LP/90. 


b.  The  System  and  Operation  Concepts 

To  achieve  the  goal,  a comprehensive  computer  system  was  created, 
containing  a compiler  and  library  routines  on  a special  Systems  Tape. 

The  compiler  enables  new  computation  subprograms  to  be  added  to  the 
library  routines,  so  that  the  new  uses  desired  by  model  builders  can 
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be  accommodated  with  relatively  minor  additions  to  the  entire  system. 

It  is  this  feature  that  enabled  the  USDA  to  add  several  entirely  new 
subprograms  of  great  porzer  and  flexibility  to  the  system  at  a small 
cost  • 

The  LP/90  systems  tape  on  which  is  maintained  the  system  compiler 
and  all  the  currently  available  "library  routines"  is  much  like  the 
FORTRAN  system.  However,  actual  conq>utations  are  performed  with  an 
Operations  Tape.  The  LP/90  Systems  Tape  is  used  to  create  an  LP/90 
Operations  Tape,  The  latter  contains  an  operation  monitor  or  executive 
routine  and  all  of  the  library  routines  including  any  new  ones  added 
during  a conq>ile.  For  a given  LP/90  run,  this  Operations  Tape  is  mounted 
on  one  of  the  computer’s  tape  units.  Its  operation  is  controlled  by 
the  user  through  the  use  of  special  control  cards.  At  the  beginning 
of  the  computer  run  when  the  Load  Tape  Button  is  pushed,  the  operation 
monitor  is  read  into  the  computer’s  core  memory  and  executed . The  first 
step  in  the  execution  is  to  read  from  the  machine’s  card  reader  a control 
card  that  specifies  which  library  routine  is  desired.  The  latter  is 
then  read  into  core  and  executed.  IJhen  that  computation  is  completed, 
a new  control  card  is  read.  After  all  the  control  cards  have  been 
read,  the  run  is  over  and  control  is  returned  to  the  machine  operators 
for  the  next  job,  whatever  it  may  be.  In  this  manual  we  will  be  con- 
cerned exclusively  with  the  use  of  the  Operations  Tape, 

To  summarize,  it  is  the  compiler  and  systems  tape  that  enable  new 
computation  subprograms  to  be  added  to  the  operations  tape.  It  is  the 
control  cards  and  library  routines  that  enable  the  user  to  tailor  the 
specific  computations  to  his  particular  needs. 


c.  The  Run  Agenda 

A series  of  LP  and  LP  related  computations  performed  at  one  time 
with  an  U?/90  operation  tape  will  be  called  an  LP/90  run,  or  run  for 
short.  The  specified  series  of  computations  is  called  an  A?»enda . The 
Agenda  describes  each  item  to  be  performed  in  the  run.  Because  of  the 
flexibility  of  the  system,  an  endless  variety  of  Agenda  is  possible. 
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The  library  routines  which  exist  on  the  Operations  Tape  are 
called  Agendum  Routines.  The  control  cards  which  cause  these  Agendiaa 
Routines  to  be  executed  are  called  Agendum  Control  Cards,  or  Ag endian 
Cards  for  short.  Thus,  a series  of  Agendum  Cards  in  the  desired  order 
define  an  Agenda. 

It  is  best  to  illustrate  these  concepts  v/ith  a short  example. 

The  input  data  for  a single  LP  problem  are  usually  punched  on  cards  and 
then  read  onto  tape  '’offline.'*^^  The  resulting  tape  is  called  the  I- tape. 
This  I-tape  and  the  LP/90  Operations  Tape  are  placed  on  the  appropriate 
tape  units  of  the  computer.  The  user  has  prepared  three  cards  with  the 
follov/ing  appearance:—'^ 


Column  # 

1 

2 

3 

4 

5 

6 

1st 

card 

I 

N 

P 

U 

T 

2nd 

card 

N 

0 

R 

M 

A 

L 

3rd 

card 

C 

u 

m 

X 

P 

T 

The  small  numbers  above  the  letters  indicate  the  card  columns  into  which 
the  agendum  name  letters  are  punched.  These  three  cards  describe  the 
agenda  for  this  run.  The  first  card  says  in  effect,  "Read  the  I-tape 
in  BCD,~^ convert  it  into  binaryi^'^data  and  store  the  results  on  the 
A-tape,"  The  A- tape  thus  contains  the  original  problem  data,  except  in 
binary  form,  and  is  ready  for  use  by  the  con^uter.  The  second  card 
says,  "Minimize  the  objective  function  subject  to  the  constraints.  That 
is,  solve  the  linear  programming  problem  described  on  the  I-tape  and  now 
in  binary  on  the  A-tape,"  The  third  card  says  finally,  '^Prepare  the 
solution  of  the  problem  just  completed  for  printing  on  the  0-tape," 

At  the  end  of  this  simple  run  the  machine  operator  dismounts  the 
0-tape  and  sends  it  to  the  printer  where  it  is  "listed,"  The  user  thenr 
obtains  this  listing,  v/hich  gives  the  solution  to  the  desired  problem. 

11/  — — 

This  might  be  done  on  a smaller  computer  such  as  the  IBM  1401,  or 

on  a special  purpose  machine  for  transferring  card  images  to  tape. 

Actually  several  additional  items  are  required  on  the  first  of 
these.  For  the  exact  appearance  of  this  card  the  reader  may  consult 
Parts  IV  or  V, 

^^BCD  means  Binary  Coded  Decimal,  the  standard  language  for 
recording  alphabetic  and  numeric  information  on  cards. 

^^The  binary  "language"  is  used  in  the  coo^uter's  internal 
operations. 
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One  may  ask,  ”Why  do  we  need  three  special  cards  for  this  run? 

In  any  case  we  v/ill  need  input  and  output.  Why  should  we  bother  to  tell 
the  machine  about  it?  Wouldn’t  it  have  been  better  just  to  push  the 
start  button  and  have  the  machine  automatically  do  all  three  items?" 

The  answer  to  this  question  will  not  be  fully  appreciated  until 
Parts  IV  and  V of  this  manual  have  been  studied.  Yet  it  is  possible  to 
indicate  even  with  this  simple  example,  v;hy  the  control  cards  are 
worthwhile.  Suppose  that  some  days  after  our  run  has  been  completed  we 
wish  to  solve  essentially  the  same  problem  as  before,  but  with  new 
right-hand- side  elements.  Would  it  not  be  desirable  to  avoid  changing 
our  original  BCD  cards,  then  doing  a card-to-tape,  and  finally  repeating 
the  same  Agenda  when  only  a small  part  of  the  data  need  changing?  As  we 
shall  see,  it  will  be  possible  to  read  the  new  right-hand- side  elements 
v/ith  a special  Agendum  Card  and  so  avoid  the  time  consuming  INPUT 
Agendum,  By  mounting  the  A-tape  from  our  original  run,  using  the 
special  Agendum  Card  for  reading  a new  right -hand- side,  we  may  proceed 
to  NORMAL  and  OUTPUT  and  save  some  expensive  computing  time  in  the  process. 

In  Part  IV  below  a series  of  sample  problems  are  presented  which 
illustrate,  in  ascending  order  of  complexity,  the  use  of  the  Agendum 
Control  Cards.  There  the  reader  may  follow  step  by  step  the  preparation 
of  data  and  Agendum  Cards  and  see  the  computational  results  for  a 
variety  of  possible  runs.  The  reader  may  i7ish  to  proceed  to  that  part 
now.  Part  V contains  a reference  guide  to  all  of  the  Agendum  routines 
and  their  corresponding  control  cards  for  USDA  LP/90.  The  Detailed 
Contents  for  Part  V gives  a list  of  all  Agendum  Routines  in  alphabetic 
order.  In  the  remaining  sections  of  this  Part  the  reader  x/ill  find  a 
detailed  description  of  how  to  prepare  input  data,  how  to  use  the 
Operations  Tape  and  how  to  interpret  the  Output  Information, 

It  will  be  difficult  no  doubt  for  the  beginner  to  use  the  remaining 
pages  of  this  part  effectively  until  he  has  studied  the  examples  of  Part 
IV.  After  that  they  may  be  used  together  with  Part  V as  a useage  reference 
manual.  Paragraphs  and  lettered  subsections  preceded  by  an  asterisk  need 
not  be  read  by  beginners.  In  some  cases  an  understanding  of  them  would 
require  collateral  readings  [see  References  at  the  end  of  the  handbook]. 
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2,  PREPARING  THE  INPUT  DATA 
a.  The  Job  Concept 

The  input  data  for  an  LP  computation  or  for  a series  of  closely 
related  LP  computations  V7ill  be  called  a job.  The  data  format  has  been 
designed,  like  the  Agendum  Control  Cards,  for  maximum  flexibility  and 
convenience  to  the  user.  Three  basic  characteristics  of  the  format 
contribute  to  this  goal.  First  is  the  ability  to  include  multiple 
objective  functions,  various  multiple  right-hand- side  vectors,  and 
multiple  "change  vectors"  for  parametric  programming.  This  enables 
the  user  to  store  compactly  data  for  many  LP  and  parametric  LP  conq>utations 
that  use  the  same  "structural"  or  "constraint"  matrix  coefficients. 

Second,  a series  of  such  "jobs"  may  be  stored  consecutively  on  the  I- tape. 
Thus,  many  computations  for  problems  with  different  "structural"  or 
"constraint"  matrix  coefficients  (and  different  dimensions)  may  be  solved 
during  the  same  run.  Third,  rows  and  columns  of  the  LP  matrix  are 
identified  by  six  character  mnemonic  names,  rather  than  sequential 
numbers.  This  greatly  facilitates  preparing  model  data,  checking  them 
for  errors,  and  reading  solution  print -outs. 

The  job  data  are  usually  punched  on  cards  from  special  format 
sheets  and  the  resulting  card  deck  "card  to  tape"  on  off-line  equipment. 
The  resulting  tape  as  noted  above  is  called  the  I-tape,  The  rules  for 
preparing  the  data  are  now  described  in  detail. 


b.  The  Title  or  Remarks  Card 

A title  card  that  identifies  the  job  data  to  folloi7  is  placed 
at  the  beginning  of  the  deck.  An  asterisk  must  be  punched  in  card 
column  1,  The  title  may  follow  in  columns  2-72,  For  example,  the 
following  hypothetical  title  card  might  be  used; 

*LP  MATRIX  FOR  SMALL  DELTA  FARMS  WITH  PRESEOT  TECHNOLOGY  AND  CLASS  I SOILS, 

Further  title  or  remarks  cards  may  be  placed  anywhere  among  the 
job  data  in  order  to  identify  portions  of  the  input. 
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The  title  cards  that  precede  the  ROW  ID  cards  (see  beloi7)  will 
be  printed  when  the  input  data  is  read  by  the  INPUT  Agendum* 


c.  Row  Identification 

The  row  names  identify  the  objective  functions,  the  change 
vectors  and  the  active  constraint  rows  of  the  LP  matrix.  The  row  names 
are  preceded  by  an  announcement  card  v/ith  ROW  ID  punched  in  card  columns 
1-6.  The  row  names  are  comprised  of  six  alphabetic  or  numeric  characters 
punched  in  card  columns  13-18.  The  first  of  these  characters  must  be 
blank  or  numeric  (1-9)  but  the  remaining  five  may  be  alphabetic  (or 
numeric  or  blank).  Of  course,  each  row  name  must  be  distinct. 

Column  12  of  the  row  Identification  cards  contains  an  indicator 
which  identifies  whether  the  row  is  (1)  an  objective  function  row  or 
objective  function  change  vector  for  parametric  programming,  (2)  an 
equation  constraint  (one  that  must  be  satisfied  as  an  equality  by  the 
solution),  (3)  an  "equal  or  less  than  equal"  inequality  constraint  or, 

(4)  a "greater  than  or  equal"  inequality  constraint.  The  character  to 
be  punched  in  each  case  is  as  follows: 


BCD  Character  Punched  Meaning  of  Character 

in  Column  12  


(1) 

Blank 

Row  is  an  objective  function  or 
change  vector  row. 

(2) 

Blank 

Row  is  an  equality  constraint. 

(3) 

+ 

Row  is  an  "equal  or  less  than 
equal"  inequality  constraint. 

(4) 

* 

Row  is  a "greater  than  or  equal" 
inequality  constraint. 

All  of  the  type  (1)  rows. 

that  is,  the  objective  function  or 

change  rows,  must  have  their  row  identification  cards  placed  first  in 
the  list.  However,  the  type  (2),  (3), and  (4)  type  rows,  that  is,  the 
active  constraint  ro^/s,  may  come  in  any  order  after  the  type  (1)  rows. 

The  purpose  of  the  indicator  column  in  the  row  identification 
card  is  to  enable  the  INPUT  Agendum  to  insert  the  appropriate  "slack" 
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vectors  during  the  conversion  to  binary  so  that  the  problem  will  be 
properly  set  up  for  solution  by  the  NORMAL  Agendum,  By  means  of  the 
indicator  column  the  user  avoids  having  to  input  slack  vectors  at  all, 

*The  user  may  optionally  place  up  to  five  row  identifications  per 
card.  This  is  done  by  punching  the  desired  number  of  ro\-7  identifications 
to  be  read  per  card  in  card  column  6,  In  this  case  card  column  24  would 
be  the  indicator  column  for  the  second  row  identification  which  would 
appear  in  card  column  25-30.  Card  column  36  would  be  the  indicator 
column  for  the  third  row  identification,  and  so  on,^^ 

*The  user  need  not  specify  all  rows  for  which  coefficients  exist 
in  the  body  of  the  matrix.  By  including  ro^7  names  for  just  those  rov7s 
that  make  up  the  desired  problem,  the  user  can  select  a subset  of  rows 
from  a very  large  basic  matrix  to  form  a given  LP  problem  for  solution, 

*A  further  option  is  available.  To  use  it  the  announcement  card 
must  be  punched  ROW  ID,  cu  where  ‘’c“  is  a tape  channel  designation 
(A  or  B)  and  ”u’‘  is  the  tape  unit  number  (0-9) , or  if  desired  it  is 
punched  ROW  ID,  CR  where  '‘CR"  indicates  the  card  reader.  In  this  case, 
the  INPUT  Agendum  will  read  from  the  specified  input  unit  the  row 
identification  card  records  and  basis  records  if  any.  The  latter  must  be 
preceded  by  the  ROW  ID  announcement  card  record  and  terminated  by  an 
additional  announcement  card  record  containing  MATRIX. 


*d.  Basis  Headings 

The  basis  headings  provide  an  .optional  feature  which  will  be  of 
primary  interest  to  experts.  The  beginning  user  of  LP/90  can  omit  this 
section  altogether. 

The  INPUT  Agendum  automatically  creates  a basis  consisting 
entirely  of  the  slack  vectors.  The  NORMAL  Agendum,  which  usually  follows 
INPUT,  begins  computations  from  this  initial  all  slack  basis.  However, 
from  previous  runs  or  other  considerations  the  user  may  have  a very  good 
idea  of  a basis  that  will  be  optimal  or  nearly  optimal.  By  prespecifying 
this  basis  he  can  force  NORMAL  to  begin  computations  with  it  and  in  this 

T C / 

A paragraph  or  subsection  preceded  by  an  asterisk  may  be 
omitted  on  the  first  reading. 
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way  he  may  diminish  the  number  of  iterations  required  to  find  the  optimal 
solution.  Unless  this  basis  is  cleverly  chosen,  however,  the  user  might 
increase  the  number  of  iterations.  Therefore,  this  option  must  be  used 
with  caution.  Two  additional  Agendum  routines  also  enable  an  initial 
basis  to  be  specified  and  for  most  purposes  these  V7ill  probably  be 
preferred.  (See  NEW. BAS  IS  and  LDHREG  in  Part  V.) 

The  basis  heading  cards  are  preceded  by  an  announcement  card 
with  BASIS  punched  in  columns  1-5.  The  matrix  column  names  are  punched 
in  card  columns  7-12  and  the  slack  names  (defined  by  active  constraint 
row  names)  which  they  are  to  replace  are  punched  in  card  columns  13-18. 
Only  slack  vectors  to  be  removed  from  the  initial  all  slack  basis  need 
be  mentioned.  The  pairing  of  colijmn  and  row  names  on  given  basis 
heading  cards  is  not  unique,  and  the  pairing  chosen  will  no  doubt  be 
changed  during  the  inversion  which  follows. 


e.  Matrix  Elements 

Following  the  row  identification  cards  (or,  optionally,  the 
basis  heading  cards)  the  user  places  the  non- zero  LP  matrix  elements. 
The  matrix  element  cards  are  preceded  by  an  announcement  card  with 
MATRIX  punched  in  card  columns  1-6.  The  non- zero  elements  are  punched 
one  per  card  in  the  following  format: 


Card  Columns 
1-6 
7-12 
13-18 
19 

20-23 

24 

25-30 

31-80 


Contents 

Blank 

Colimin  name 
Roi7  name 

Sign  of  element  (blank  s + .) 

Integer  part  of  element  (must  be 
less  than  9999) 

Decimal  point  must  be  punched 

Fractional  part  of  element  (trailing 
zeros  may  be  left  blank) 

Any  identifying  comment  or  blank. 


^^^Columns  20-30  may  vary  from  this  recommended  format. 
Reference  Manual,  CEIR,  Inc.,  Arlington,  Virginia. 


See  IP/ 90 
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The  columns  can  be  in  any  order,  but  all  the  elements  of  one  column 
must  be  together.  The  order  of  rows  within  a given  column  is 
arbitrary.  In  any  case  the  rows  will  be  ordered  to  match  the  order  of 
the  rov7  identification  cards.  Any  element  with  a row  name  not  given  in 
the  row  identification  list  is  omitted  by  the  IM*UT  Agendum, 

*An  optional  feature  is  the  splitting  of  matrix  elements  into 
groups  of  vectors  indicated  by  the  announcement  cards  PARTITION  or 
CURTAIN.  However,  the  usage  of  this  option  has  largely  been  superseded 
by  the  special  Agendum  Routine  FLAGS.  For  this  reason  these  options 
will  not  be  described  here.  For  reference  see  Part  V,  Section  1,  Il^UT. 

*In  order  to  facilitate  checking  the  input  data  provision  is  made 
for  including  count  or  sum  cards  at  the  end  of  the  element  cards  for  a 
given  vector.  A card  containing  SUM  in  card  columns  4-6  has  the  arithmetic 
sum  of  the  element  values  in  the  vector  in  card  columns  19-30.  A card 
containing  CNT  in  card  columns  4-6  has  the  number  of  non- zero  elements 
in  the  vector  in  card  columns  20-23  with  a decimal  in  card  column  24, 


f.  Right-Hand-Side  or  Constraint  Vector  Elements 

The  right-hand- side  or  constraint  vector  elements  are  preceded 
by  an  announcement  card  punched  FIRST  B in  card  columns  1-7.  (A  blank 
must  be  left  in  column  6.)  Column  names  may  be  punched  for  the  user's 
convenience,  but  they  are  never  used  by  the  system.  The  row  names, 
non-zero  elements,  and  the  arbitrary  remarks  format  is  identical  to 
that  of  the  matrix  element  cards  (subsection  e above). 

Additional  right-hand- side  elements  can  be  added.  The  non- zero 
elements  for  each  such  right-hand- side  must  be  preceded  by  an  announcement 
card  punched  NEXT  B,N  where  N is  an  integer  greater  than  1 and  less  than 
9999,  N gives  the  number  of  the  right-hand- side.  The  right-hand- sides 
must  be  numbered  in  an  ascending  but  not  necessarily  consecutive  order, 

*At  the  user's  option  the  FIRST  B announcement  card  may  be 
replaced  with  the  announcement  card  FIRST  B,cu  where  "c”  and  "u”  describe 
the  tape  channel  and  tape  unit  respectively,  or  are  punched  CR  for  the 
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card  reader.  The  INPUT  Agendum  will  then  seek  the  specified  input  unit 
to  obtain  the  right-hand-side  elements  (including  multiple  right-hand- 
sides)  . In  this  case  the  specified  right-hand-side  elements  must  be 
preceded  by  the  FIRST  B announcement  card  and  followed  by  an  EOF  card. 


g.  End  of  a Job 

All  of  the  above  data  and  their  respective  announcement  cards 
are  followed  by  a card  punched  EOF  in  card  columns  1-3.  Columns  4-6 
must  be  blank.  The  first  such  EOF  card  may  be  followed  by  any  number  of 
additional  complete  jobs  as  described  in  Sections  b-f  above.  Each  such 
job  is  terminated  by  an  EOF  card. 


h.  Summary  of  Input  ( I -Tape)  Data 

Figure  10  shows  the  input  deck  arrangement  as  just  described. 
The  reader  may  turn  to  Part  IV,  Section  1,  Table  18,  for  a listing  of 
a sample  input  deck.  Figure  11  shows  a schematic  diagram  of  the  data 
for  an  LP  problem.  In  everything  that  follows  we  shall  call  the  data 
in  this  form  (or  on  I-Tape)  an  "LP  Matrix." 
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Other  jobs 

Data  Announcement 


FIGURE  10 
INPUT  CARD  ORDER 
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FIGURE  11 

SCHEMATIC  DIAGRAM  OF  LP  MATRIX 
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3.  OPERATING  THE  LP/90  SYSTEM 

a.  Machine  Requirements 

USDA  LP/90  can  be  used  with  the  IBM  709,  7090,  or  7094  computers, 
A special  system  called  LP/94  is  being  written  for  the  7094  computer. 

The  latter  will  be  more  efficient,  but  LP/90  is  still  very  fast,  even 
when  used  on  the  7094,  and  has  the  further  utility  of  being  compatible 
with  the  709  as  well  as  7090.  Similar  systems  (at  the  time  of  this 
writing)  are  in  preparation  for  the  IBM  7070,  7074,  and  7040  computers. 

USDA  LP/90  requires  an  on  line  card  reader  (for  reading  the 
Agenda),  an  on  line  printer  (for  printing  progress  and  error  messages) 
at  least  five  tape  units  on  channel  A and  at  least  four  tape  units  on 
channel  B.  An  on  line  card  punch  is  ordinarily  required,  though  a 
version  of  the  system  can  be  employed  that  does  not  require  this 
particular  output  unit. 

b . Tap  e As  s ig  nment  s 

LP/90  uses  tapes  on  two  input-output  channels,  A and  B.  The 
usual  assignments  are  as  follovrs: 


Channel 

Unit 

LP/ 90  Symbol 

Content 

A 

1 

S-Tape 

LP/90  Operations  Tape 

A 

2 

A- Tape 

Binary  LP  Matrix  (Created  by 
INPUT,  TRANSFORM,  REVISE  or  RESTART) 

A 

3 

B-Tape 

Backward  Eta  (Used  by  NORMAL) 

A 

4 

M-Tape 

Binary  or  Mediary  Output  Tape* 

A 

5 

U-Tape 

Scratch 

A 

6-0 

None 

Available  for  any  optional  infjut 
or  output 

B 

1 

I- Taps 

BCD  LP  Matrix  (Original  Input  Data) 

B 

2 

0-Tape 

BCD  Output  Tape  (Created  by  OUTPUT) 

B 

3 

F-Tape 

Forward  Eta  (Used  by  NORMAL) 

B 

4 

V-Tape 

Scratch 

B 

5-0 

None 

Available  for  any  optional  input 
or  output. 

B6 


*If  a 709  is  being  used,  all  of  these  tapes  must  be  1,0X7  Density 
tapes.  If  a 7090,  or  7094  is  being  used  MOD  IV,  Hi-Density  tapes  are 
preferred  for  all  units  except,  possibly,  the  I-  and  0-tapes,  The 
choice  of  Hi-  or  Lox7-Density  tapes  for  the  I-  or  0-tapes  depends  on  how 
the  off-line  card  to  tape  for  the  I-tape,  and  the  tape  listing  of  the 
0-tape  is  performed. 


c.  Normal  (iteration 

The  USDA  LP/90  Operations  Tape  is  placed  on  tape  unit  A1  and 
set  to  load  point.  The  I-tape  is  loaded  on  unit  B1  and  set  to  load 
point.  Finally,  the  M-tape  (A4)  should  be  set  to  load  point.  All 
other  tapes  are  automatically  rex7ound.  Remember  that  the  I-tape  has 
been  card-to-taped  off-line. 

The  Agenda,  made  up  of  the  Agendum  Control  Cards  prepared  by 
the  user,  is  placed  in  the  on-line  card  reader. 

The  '*Clear*'  and  ’’Load  Tape”  buttons  are  pushed  in  succession. 
From  this  point  on  LP/90  is  in  command,  reading  Agendum  Cards  one  after 
the  other,  and  executing  the  specified  Agendum  Routines  in  turn.  If  no 
trouble  is  encountered  during  the  run,  the  final  OUTPUT  Agendum  X7ill 
convert  the  binary  (mediary)  M-tape  to  BCD  on  the  0-tape  for  printing. 
At  the  run’s  termination  the  latter  is  dismounted  and  a listing 
obtained  off-line. 


*d.  Sense  Switch  Controls 

The  operation  of  LP/90  can  be  controlled,  not  only  by  means  of 
the  Agendum  Control  Cards,  but  also  by  means  of  the  computer’s  Sense 
Switches.  Placing  a Sense  Switch  doxm  during  operation  permits  selected 
monitoring  of  the  computations  or  aids  in  executing  appropriate  responses 
to  error  conditions.  The  possible  uses  are  as  follows: 


S7 


Sense  Switch 

#1  . . . , 


#2 


a 


#4 


Use 

If  placed  down  during  the  operation  of  INTRODUCE, 
NORMAL,  DO.PLP  or  DO.PCR  the  GETOFF  Agendum  will  be 
executed  at  the  termination  of  the  current  iteration. 
This  enables  a long  run  to  be  Interrupted  so  that 
other  higher  priority  programs  can  be  run  without 
wasting  the  computations  already  completed,  (See 
Part  V GETOFF.) 

If  placed  down  during  operation  of  INTRODUCE,  NORMAL, 
DO.PLP,  or  DO.PCR,  the  cuurrent  iteration  will  be 
completed,  the  Agendum  terminated  and  the  card  reader 
consulted  for  the  next  Agendum.  If  placed  down  before 
exercising  GETOFF,  the  latter  Agendum  will  use  the 
B-tape  (Baclcward  Eta)  for  the  GETOFF  output. 


If  placed  down  at  beginning  of  run,  a "by-pass" 
feature  is  initiated  that  vjill  automatically  cause 
the  OUTPUT  Agendum  to  be  executed  if  certain  imexpected 
stops  occur.  These  stops  are  as  follows: 


Stop  In 

Messace 

NORMAL 

NO  FEASIBLE  SOLUTION 
UNBOUNDED  SOLUTION 

DO.PLP 

THETA  UNBOUNDED 

DO.PCR 

PHI  UNBOUNDED. 

Uhen  placed  in  down  position  during  NORMAL,  an  optimal 
solution  will  be  follov/ed  automatically  by  a d^  check 
in  double  precision.  This  will  precede  the  reading 
of  the  next  Agendum  card.  If  all  d^  > 0 without  a 
tolerance  and  if  | d^ | < tolerance  for  all  j in  the 
basis  headings,  operation  of  the  rvin  will  proceed 
normally.  If  any  d^  < 0 or  if  any  [d^j  > tolerance 
for  j in  the  basis  headings,  those  j together  with 
d^  will  be  output  to  the  mediary  tape  and  a halt 
will  occur  after  an  on-line  message.  If  sense  switch 


2 is  nov7  placed  in  the  dof\7n  position  and  the  computer 
started,  the  next  Agendum  card  V7ill  be  read.  If  the 
computer  is  started  v/ith  sense  switch  2 up,  control 
will  revert  to  NORMAL.  See  references  [ ll] . 

a)  If  placed  in  the  doxm  position  during  INTRODUCE, 
NORI'I/\L,  INVERT,  DO.PLP  or  DO.PCR,  a »cvcle  print » 
will  be  output  on-line  at  the  end  of  the  current 
iteration.  If  the  switch  is  restored  to  up 
position  at  any  time  during  printing  (after  the 
headings),  printing  will  terminate.  Note  that 
sv/itch  5 must  be  restored  '*on  the  fly”  after 
printing. 

b)  If  placed  doxTn  at  the  Matrix  Singular  stop  in 

INVERT,  a full  printout  containing  v;ill  be 

s 

X'/ritten  on  the  mediary  tape.  (Not  on-line.) 

See  [ 11]  . 

If  placed  in  the  dovm  position  during  INTRODUCE,  NORMAL 
I^IVERT,  DO.PLP  or  DO.PCR,  the  solution  will  be  checked 
at  the  end  of  the  current  iteration.  If  any  error 
exceeds  the  tolerance  in  use,  then  a halt  occurs. 

If  sv/itch  6 is  left  doxni  and  the  computer  started,  a 
“check  solution"  print  occurs  on-line  followed  by  the 
same  halt.  If  the  switch  is  put  up  and  the  computer 
started,  normal  operation  resumes.  Note  that  switch 
6 must  be  restored  "on  the  fly"  after  the  check  if 
all  errors  are  vzithin  the  tolerance.  Printing  will 
terminate  if  the  sx/itch  is  restored  to  up  position 
at  any  time  during  printing  (after  headings). 
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*e.  Summary  of  Error  Halts  and  Operator  Response 

The  normal  termination  of  all  Agenda  except  GETOFF,  RESTART,  and 
OUTPUT  is  to  read  the  next  Agendum  Card.  Ho^jever,  certain  halts  may 
occur  because  logical  errors  have  been  made  in  structuring  the  model, 
or  because  of  faulty  input  data.  Before  the  machine  ”halts"  an  error 
message  is  printed.  These  follow  along  Xi7ith  a brief  interpretation  and 
suggested  response, 

i)  ‘*MAXIMUM  ERROR  ON  ROW " 

This  may  occur  at  a check  solution  during  INTRODUCE,  NORMAL, 
INVERT,  DO.PLP,  or  DO.PCR.  If  the  error  is  small  press 
START  to  continue,  (INVERT  may  clear  up  digital  trouble.) 

If  the  error  is  large  it  may  be  due  to  machine  malfunction, 

to  wrong  input  data,  or  more  probably  to  a bad  Agendum 
sequence  such  as  LDBINARY  NORMAL, 

ii)  •‘MONOTONICITY  CHECK  — — 

This  V7ill  occur  during  NORMAL  when  the  solution  is  feasible 
if  the  change  in  current  value  is  greater  than  tolerance 
in  the  ’hTrong"  direction.  Press  START  continues.  If  the 
error  is  large  'suspect  machine  trouble. 

iii)  ''SELECTED  VECTOR  IN  BASIS ” 

This  will  occur  in  NORMAL,  PLP,  or  PCR  ,if  the  vector  chosen 
is  already  in  the  basis.  It  is  ordinarily  due  to  digital 
error  exceeding  the  DJ  tolerance.  Press  START  ignore.s 
the  vector  and  continues;  however,  the  algorithm  usually 
terminates  xi7ith  no  further  iteration.  If  it  terminates  in 
NORMAL  with  an  infeasible  solution,  the  message  NO  FEASIBLE 
SOLUTION  is  printed;  if  it  terminates  NORMAL  and  the 
solution  is  feasible,  an  OPTIMAL  termination  results;  if 
it  terminates  in  PLP,  a THETA  AT  MAX  termination  results; 
if  in  PCR,  a PHI  AT  MAX  termination  results. 

iv)  "MATRIX  SINGULAR VECTOR  DELETED " 

This  will  occur  in  INVERT  if  no  pivot  element  greater  than 
8 X 10  ^ can  be  found.  Press  START  continues  and  ignores 
the  vector.  (See  Part  V,  IITORT  for  other  options.) 
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v)  "NO  FEASIBLE  SOLUTION*' 

This  can  occur  in  N0R1*IAL  due  to  faulty  problem  formulation, 
or  occasionally  it  may  be  due  to  digital  trouble.  Press 
START  twice  goes  to  read  the  next  Agendum. 

vi)  ’’UNBOUNDED  SOLUTION” 

This  may  occur  in  NORMAL  due  to  faulty  formulation,  Tliere 
is  also  the  remote  possibility  that  a legitimate  pivot 
(when  the  solution  is  feasible)  has  been  rejected  and  no 
other  can  be  found.  Continuation  is  possible  by  pushing 
START  to  read  the  next  Agendum  card. 

vii)  ’’THETA  UNBOUNDED” 

This  occurs  in  PLP  when  no  limiting  row  (vector  leaving) 
can  be  found.  Press  START  reads  the  next  Agendum.  This 
does  not  mean  that  the  problem  is  unbounded,  but  only 
that  one  can  extrapolate  to  any  finite  value  of  theta 
x^ithout  a change  of  basis. 

viii)  ”FHI  UNBOUNDED” 

This  occurs  in  PCR  when  no  vector  to  enter  the  basis  can 
be  found.  Press  START  reads  the  next  Agendum.  This  does 
not  mean  that  the  problem  is  unbounded,  but  only  that  one 
can  extrapolate  to  any  finite  value  of'  PHI  without  a change 
of  basis. 

ix)  ’’CAN'T  FIND  VECTOR  ON  A- TAPE” 

This  may  occur  in  the  subroutine  CHECK  used  by  NORMAL, 
INTRODUCE,  PLP,  PCR,  INVERT.  Press  START  tries  again, 
trouble  in  this  case  would  probably  be  due  to  machine  error. 

x)  ’’CAN'T  FIND  XXX  BASIS  VECTORS  ON  A- TAPE” 

This  may  occur  in  INVERT  when  some  narae(s)  is  (are)  specified 
in  the  basis  headings  which  cannot  be  found  on  the  A-tape, 

The  number  of  vectors  not  found  is  given  as  XXX,  Press 
START  continues  V7ith  INVERT;  the  final  basis  will  have 
artificial  variables  corresponding  to  the  vectors  not  found. 
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xi)  »'CAN*T  FIND  RIGHT- HAND- SIDE” 

This  may  occur  in  NORMAL,  INTRODUCE,  PLP,  PCR,  and  INVERT. 


Press  START  reads  the  next  Agendum.  Input  data  should  be 
checked.  Also  check  parameter  used  on  Agendum  Card, 

xii) 

‘'INPUT  ERRORS" 

This  occurs  in  INPUT.  Press  START  reads  the  next  Agendum. 
Sense  switch  3 goes  to  OUTPUT,  Print  O-tape  for  more  detail; 
Check  I- tape  carefully. 

xiii) 

"REDUNDANCY" 

This  may  occur  in  any  routine;  see  the  detailed  operating 
instructions  [ll]  for  possible  continuation. 

xiv) 

"GETOFF  COMPLETE  START  WITH  SS2  DOWN  READS  NEXT  AGENDUM" 

If  Sense  Sv/itch  2 is  up  the  GETOFF  is  duplicated  on  the 
B-tape, 

xv) 

"RESTART  COMPLETE  START  WITH  SS2  DOWN  READS  NEXT  AGENDUM" 

If  Sense  Switch  2 is  up  the  last  Agendum  (prior  to  GETOFF) 
is  actuated. 

xvi) 

"INFEASIBLE  SOLUTION  CANNOT  DO  PLP  (PCit)" 
Press  START  reads  next  Agendum. 

There  are  miscellaneous  other  stops  without  on-line  messages.  They 
usually  indicate  machine  trouble.  Other  stops  with  on-line  messages  are 
possible,  but  these  v/ill  usually  be  self-explanatory. 
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4.  OUTPUT  FORMAT 

a.  Operation  Comments  and  the  Run  History 

LP/90  output  is  printed  on-line  or  tnritten  on  a tape  for  subsequent 
printing  (0-tape)  or  is  in  the  form  of  restart  information  on  tape  or 
punchout  cards.  The  progress  of  a run  may  be  followed  on-line  where 
comments  and  important  data  are  printed.  Most  of  the  results  are  for 
off-line  printing.  By  means  of  the  CONTROLS  Agendum  Card  the  user  can 
control  the  amount  of  different  kinds  of  output.  (See  Part  V,) 

The  output  data  and  operation  comments  are  intermixed  in  general. 
V7ith  but  few  exceptions,  all  output  printed  on-line  is  also  printed  off- 
line, Thus  the  off-line  output  contains  a nearly  complete  history  of 
the  run. 


b.  Types  of  Computation  Output 

Computation  results  are  output  in  four  styles: 

1.  Single-line  summaries  in  tabular  form  with  occasional 
captions  printed. 

2.  Full  listings  of  the  current  solution  v?ith  appropriate 
headings,  captions,  etc. 

3.  Full  tables  of  special  output  as,  for  example,  the  d^ 
quantities  produced  by  the  DO.D/J  Agendum,  or  the  matrix 
element  output  produced  by  PICTURE, 

4.  Cycle  prints,  a special  form  of  full  output  for  on-line  use 
only.  The  special  output  as  well  as  operation  coraments 
(Items  3 and  4)  are  more  or  less  self-explanatory, 

A full  listing  of  the  current  solution  consists  of  headings, 
captions,  a one-line  summary  and  five  columns  of  m + 1 entries,  where 
m is  the  nxjmber  of  rows  in  the  LP  matrix. 
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c.  Output  Summary  Line 

The  headings  for  the  summary  are  as  follows: 

Heading  Item  Printed  Below  Heading 


TOTAL 

ITERS 

The  total  number  of  simplex  iterations  since  the 
start  of  the  job.  (Does  not  count  inversion 
iterations  or  transformation  made  in  input.) 

NO. 

ETAS 

The  total  number  of  eta-transformations  now  in  effect. 
One  is  produced  by  each  simplex  iteration  and  each 
inversion  iteration.  This  starts  over  with  an  INVERT 
instruction,  (Counts  transformations  made  in  INPUT 
or  REVISE.) 

ETA 

Number  of  eta  records  (zero  for  in  core  problems). 

RCX7 

INDENT. 

The  row  name  of  the  objective  function  now  being 
minimized. 

SUM  OF 
INFEAS. 

This  is  a measure  of  the  infeasibility  (sum  of  the 
negative  beta  values)  still  in  the  system.  It  may 
not  decrease  monotonically.  When  feasibility  occurs, 
it  is  replaced  by  CURRENT  VALUE,  r?/ 

CURRENT 

VALUE 

IThen  the  solution  is  feasible,  this  is  value  of 
objective  function.  It  should  increase  monotonically 
during  NORMAL  when  the  scale  factor  is  positive. 
During  PCR  it  is  the  current  value  of  the  composite 
objective  function. 

CHOSEN 

VECTOR 

The  name  of  the  variable  entering  the  basic  solution 
during  the  current  iteration. 

' VECTOR 
REMVD 

The  name  of  the  variable  being  replaced  in  the  solution 
during  the  current  iteration.  This  is  not  the  ro\J 
position  on  which  the  pivot  occxirred. 

RHS 

NO. 

The  numerical  identification  of  the  right -hand- side 
currently  in  use. 

C/V 

NO. 

Change  vector  number  or  change  row  number  currently 
in  use. 

NO.  OF 
INFE 

CURRENT 

D/J 

THETA/PHI 

The  number  of  non-zero  infeasibilities  remaining,  / 

Replaced  by  CURRENT  B/J  when  solution  is  feasible."^ 

If  feasible  and  in  NORMAL,  value  is  the  current  D/J;  of 
vector  entering  basis,  i.e.,  the  min.  D/J,  If  in  DO.PLP, 
or  DO, PCR,  value  is  the  current  value  of  Theta  or  Phi. 

~^The  headings  may  not  change  immediately  when  feasibility  occurs. 
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d.  Full  Print-Out  of  Solution 

Of  the  five  columns  in  a full  print-out,  the  first  three  are 
standard  and  are  headed  J(H),  BETA(H),  and  ROW(I) , The  various  columns 
are  described  below: 

(1)  Basic  Solution:  The  column  headed  J(H)  is  the  list  of 

variables  in  the  current  basic  solution.  Artificial  variables  have  no 
name  and  are  printed  as  0 00000  in  the  list.  All  profit  rows  are 
considered  artificial  and  always  appear  in  every  basic  solution.  At 
least  one  other  artificial  variable,  usually  SIGMA,  will  remain  through 
the  run  if  SIGMA  was  required. 

(2)  Values  of  Basic  Variables;  The  column  headed  BETA(H)  contains 
the  values  of  the  basic  variables  listed  under  J(H)  in  the  same  order. 

This  order  is  unpredictable  as  is  the  set  of  basic  variables  chosen.  Hence, 
the  identification  under  J is  an  essential  part  of  the  solution  listing. 

(3)  Row  Names:  The  column  headed  ROW(I)  is  merely  a list  of 

the  rov7  names  as  specified  by  the  input.  It  is  provided  for  convenience 
and  is  placed  in  the  middle  of  the  page  because  the  fourth  and  fifth 
columns  are  in  proper  rov;  order. 

(4)  Printing  of  Dual  Variables  (Shadow  Prices):  The  fourth 

column,  headed  PI(I),  is  the  ’’pricing"  vector  used  in  the  composite 
algorithm.  This  column  is  blank  for  INVERSION  print-outs.  If  the 
solution  is  feasible  and  optimal,  this  is  the  solution  of  the  dual 
problem,  the  so-called  "shadow  prices."  During  PGR  this  is  the  PI  vector 
corresponding  to  the  composite  objective  function. 

(5)  Printing  of  Right -Hand- S ide : The  fifth  column,  x\hen  headed 

B(I),  is  the  given  right -hand -side,.  During  DO.PLP,  solution  prints  are 

"fc 

labeled  CURRENT  RT.H.SIDE  and  this  column  is  headed  B(I)  + T C(I)  inhere 

B(I)  = B.  = Original  right-hand- side  values 
T C(l)=  0 ^ Current  value  of  Tlieta 

C(I)  ss  = Change  vector  values. 
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At  PHI  UNBOUNDED  the  5th  column  is  headed  PI(SIGMA);  it  is  then 
the  row  of  the  inverse  corresponding  to  the  change  cost  row.  It  can  be 
used  to  extrapolate  to  any  desired  level  of  PHI  by  adding  the  appropriate 
delta  times  PI(SIG14iV)  to  PI,  The  Beta  values  do  not  change.  The  new 
Current  Value  will  be  the  sum  over  the  functional  rows  only  of  PI(com- 
posite)  values  times  the  corresponding  BETA  values. 

The  THETA  UNBOITOED  the  5th  column  is  headed  GAMMA(H);  it  is  then 
the  negative  of  the  change  vector  (RHS),  expressed  in  terms  of  the  current 
basis.  The  effect  of  using  any  desired  (positive)  amount  of  this  vector 
can  be  found  by  subtracting  the  appropriate  amount  times  GAMMA  from  BETA, 
A cycle  print  on-line  (via  sense  switch  5)  has  a sixth  column 
labeled  ETA.  This  is  the  current  transformation. 

A check  solution  on-line  (via  sense  ST7itch  6)  has  a sixth  column 
labeled  ERR.  This  is  B-  A*BETA. 

The  special  prints  for  INPUT,  DO.D/J,  TABLEAU,  and  sense  sv/itch 
5 during  INVERT  are  covered  under  the  description  of  those  Agendum 
Routines,  (See  Part  V,) 


PART  IV:  SAMPLE  COMPUTATIONS  WITH  USD A LP/90 


INTRODUCTION 

The  old  saw  has  it  that  the  proof  of  the  pudding  is  in  the  eating. 

To  the  user  the  proof  of  a computer  program  is  surely  in  the  computing. 

In  this  section  USDA  LP/90  is  put  to  work,  computing  a series  of  six 
sample  problems.  They  are  placed  in  order  of  ascending  complexity,  each 
example  illustrating  several  specific  Agendum  routines.  In  this  way  the 
principles  of  the  system  are  illustrated  concretely  and  one  may  derive 
a very  specific  understanding  of  them.  Further,  it  is  hoped  that  the 
examples  will  indeed  show  that  USDA  LP/90  is  a powerful  tool  for  agri- 
cultural economics  research,  just  as  its  other  versions  have  proved  to  be 
powerful  tools  in  many  other  fields. 

At  the  completion  of  this  Part  the  prospective  user  will  be 

familiar  with  some  of  the  most  powerful  of  the  SHARE,  PROP,  and  USDA 

10/ 

Agendum  routines. — It  would  have  been  impossible  to  include  an 
illustration  of  each  and  every  Agendum  routine  available  for  users  of 
USDA  LP/90.  However,  armed  with  a specific  knowledge  of  those  presented 
here,  one  can  confidently  exploit  on  his  own  the  full  list  briefly 
described  in  Part  IV. 

The  discussion  of  each  example  is  divided  into  five  sections  that 
take  up  in  turn  the  purpose,  data,  agenda,  output  and  interpretation  of 
the  sample  problem.  A small  linear  programming  model  is  used  as  the  common 
basis  for  all  the  examples,  though  it  is  progressively  extended  as  more 
complex  Agenda  are  illustrated.  The  reader  will  see  that  it  is  only  a 
modest  generalization  of  the  illustrative  model  used  in  Part  II  above. 

The  model  is  designed  to  serve  as  a vehicle  for  illustrating  the  Agenda 
concept  and  use  of  LP/90.  As  a description  of  real  farm  production  for 
any  particular  time  or  place  it  would  be  inadequate.  But  that  is  quite 
beside  the  point. 

Most  of  the  Agendum  control  cards  have  several  optional  forms. 

In  discussing  the  sample  Agenda,  only  the  options  actually  used  are 
described  here.  It  is  only  in  Part  V that  all  of  these  details  are 
presented . 

To  facilitate  reading,  the  tables  ^re  placed  together  at  the  end 
of  the  lettered  subsection  in  which  they  are  first  mentioned. 


'■ , / For  an  ex^  lanation  of  this  threefold  classification  or  the 
Agendum  routines,  see  Part  I,  INTRODUCTION. 


1.  A SINGLE  LP  PROBLEM 
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a.  Purpose 

To  begin,  a very  simple  example  is  considered.  Five  Agendum 
routines  will  be  needed  and  a single  LP  problem  solved.  However,  it  will 
take  some  space  to  develop  the  data  for  the  example.  This  same  data  will 
also  serve  for  the  more  complicated  examples  which  follow.  Because  of 
these  multiple  uses  it  will  be  well  in  the  beginning  to  describe  it  in 
some  detail. 


b.  Data 

Our  sample  model  consists  of  several  components.  First,  seventeen 
production  processes  or  activities  are  included.  They  describe  the  pro- 
duction of  five  crops  on  two  different  soil  types  at  two  different  levels 
of  fertilization.  One  crop,  cotton,  is  assumed  to  have  two  different 
technical  "stages"  of  production,  one  involving  hand  harvesting,  the 
other,  machine  picking.  The  character  of  these  processes  is  summarized 
in  Table  16. 

Table  17  briefly  describes  the  constraints  on  the  process  levels. 
They  include  the  amount  of  land  in  each  of  two  soil  classes,  the  supply 
of  labor  during  the  harvest  season,  the  supply  of  fertilizer,  acreage 
allotments  on  cotton  and  rice  producing  activities,  upper  and  lower 
bounds  on  the  total  acreage  devoted  to  each  crop  (flexibility  constraints), 
and  finally,  mechanical  cotton  picker  capacity. 

19/ 

Next,  Table  18  gives  the  LP  Matrix  in  LP/90  input  form. — The 

first  row  of  the  table  gives  the  objective  function.  As  LP/90  is  designed 

to  minimize  a linear  function,  the  objective  row  contains  negative 

coefficients  indicating  positive  profits  to  be  maximized.—'^ 

In  short,  the  linear  programming  model  for  this  example  is  to 

minimize  (=  maximize  the  negative)  objective  function  in  the  row  marked 

21/ 

"bZlbbb" — subject  to  the  constraints  whose  coefficients  are  described 
in  the  following  rows  of  the  table. 


19/  See  Part  II,  Section  7. 

20/  See  Part  II,  Section  l.d, 

21/  Lower  case  letter  "b"  means  blank. 


The  coefficients  of  the  lower* bound  constraints  marked  LBCOT, 

22/ 

LBOAT, — etc.,  are  minimal  limits  on  the  sum  of  the  process  levels 

for  each  commodity,  respectively.  That  is,  they  could  have  been  written 

as  '’greater  than  or  ecual  to"  constraints.  In  that  case,  the  appropriate 

input  coefficients  would  be  plus  ones  instead  of  negative  ones,  and  their 

respective  row  identification  cards  would  have  minus  signs  punched  in 

indicator  column  12.  Either  treatment  is  equally  valid  and  the  choice 

23/ 

between  them  immaterial. — 

The  input  data  were  transcribed  from  Table  18  onto  special  LP/90 
Matrix  Element  format  sheets  for  key  punching.  Table  19  shows  the  first 
page  of  this  input  to  the  key  punchers.  After  keypunching,  the  cards 
were  listed.  Table  20  shows  this  listing.  These  cards  were  then  written 
onto  tape  (the  I-tape)  by  the  "off  line"  equipment.  The  card  listing  of 
Table  20  appears  just  as  a listing  of  the  I-tape  would  appear,  except  that 
the  pages  have  been  trimmed  and  pasted  together  to  conserve  space. 


22/  The  bar  over  the  letter  "Oh"  is  used  to  distinguish  it  from 
the  number  zero. 

23/  See  above.  Part  III,  Section  2.c. 
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Table  16:  Summary  of  Activities  or  Processes  for  the  Sample  Model 


Column 

Crop 

Technology 

Soil 

Fertilizer 

Symbol 

Stage 

Level 

ICOTll 

Cotton 

1 

1 

1 

1C0T12 

M 

1 

1 

2 

1C0T21 

H 

1 

2 

1 

1C0T22 

It 

1 

2 

2 

2C0T11 

It 

2 

1 

1 

2C0T12 

It 

2 

1 

2 

2C0T21 

It 

2 

2 

1 

2COT22 

It 

2 

2 

2 

lOAXll 

Oats 

1 

1 

1 

1QAT12 

It 

1 

1 

2 

1QAT21 

It 

1 

2 

1 

1QAT22 

tt 

1 

2 

2 

ISBGll 

Soybeans 

1 

1 

1 

1SBG21 

It 

1 

2 

1 

lALFll 

Alfalfa 

1 

1 

1 

1RIC21 

Rice 

1 

2 

1 

1RIC22 

II 

1 

2 

2 

Table  17:  Sianmary  of  Constraints  for  Sample  Model 

Row  Symbol 

Type  of 

Constraint 

SOIL  1 

Soil 

Class  1 

SOIL  2 

Soil 

Class  2 

LABP4 

Unskilled  Labor  Fourth  Quarter  (Dct-Dec  ) 

PERT 

Fertilizer 

LOTCT 

Acreage  Allotment 

Cotton 

LOTRC 

II 

A 

Rice 

UBCOT 

Upper 

Bound 

Cotton 

UBQAT 

II 

II 

Oats 

UBSBG 

It 

II 

Soybean  Grain 

UBALF 

II 

II 

Alfalfa 

UBRIC 

It 

II 

Rice 

LBCOT 

Lower 

Bound 

Cotton 

LBOAT 

II 

II 

Oats 

LBSB6 

II 

It 

Soybean  Grain 

LBALF 

It 

II 

Alfalfa 

LBRIC 

II 

II 

Rice 

S2C0I 

Stage 

2 

Cotton  Capacity 

LP  MATRIX  FOR  SINGLE  LP 
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Form  B 


Table  19 

KEYPUNCHING  FOKM  FOR  MATRIX  ELEMENTS 


KEYPUNCH:  col.  24  punch  dec.  pt.  SHARE  STANDARD 


ANNOUNCEMENT 

COLUMN  NAME 

ROW  NAME 

VALUE 

1 

k,5,w,  ,1,0 

7 

12 

1 1 1 1 

13 

18 

1 1 1 1 

19 

24 

• 

28'  SO 

1 1 1 1 1 

2 

1 1 1 1 1 

1 1 1 1 

Z.l,  . , 

• 

1 1 1 1 1 

a 

. 1 . .4“ 

5.0  .X.L.l 

1 1 1 

• 

1 1 1 1 1 

4 

, 1 . .4 

S.5.1.L5L 

• 

1 1 1 1 1 

5 

, , , .+ 

1 1 1 

• 

6 

1 1 1 1 1 

F,E./?.T, 

• 

1 1 1 1 1 

7 

1 1 1 1 1 

L,?,T,C,T 

1 1 1 

• 

1 1 1 ' 1 1 

8 

I 1 1 1 I 

t.o.T.R.C 

1 1 1 

• 

9 

1 1 1 1 1 

1 1 . 1 + 

U,B,C,3,t 

• 

1 f 1 I 1 

10 

1 1 1 1 1 

...  4 

U,B.5,A.T 

• 

11 

1 1 1 1 1 

. . . .+ 

U,6,S,B.G. 

• 

1 t 1 1 1 

12 

1 1 1 1 J 

. . . .4 

1 t 1 

• 

13 

11111 

U £ ,R  ,1  ,C 

• 

1 1 1 1 1 

14 

...  ,4 

i.e.c.o.T 

1 1 1 

• 

1 t 1 1 1 

18 

...  .4 

1.8. 5.  AT 

• 

1 t 1 1 1 

16 

1 1 1 1 1 

...  .4 

L,6,S,B,^ 

• 1 

1 I I 1 1 

17 

...  .4 

l.t.A.L.F 

• 

1 1 1 1 1 ‘ 

18 

1 1 1 1 1 

. . . .t 

i.S.RJC 

1 1 1 

• 

19 

1 1 1 1 1 

...  .4 

s.a,c,5,T 

• 

1 1 1 1 1 

20 

Af.A.T.R.I.Y 

1 1 1 . 

.1.1 

1 1 1 

• 

1 1 . 1 1 

21 

1 1 1 1 1 

1 

r,i,3 

f.l.  . . 

- 

, 3S 

• 

/.6.  . . . 

22 

1 1 1 1 1 

1 1 

s.5xi.i 

. . ./ 

• 

^.Oi  1 1 

23 

1 1 1 1.1 

1 1 

, , 

' 

?,0,  , , , 

24 

1 1 1 1 1 

1 1 

LjS.TCT 

, , .1 

• 

D.O.  , , . 

25 

1 1 1 1 1 

1 1 

t/.8,C,0.T 

, , ,/ 

• 

6.0.  , , , 

26 

1 1 1 1 1 

\ 

1 1 

* 

L.B.C,3,T 

— 

, , ,/ 

• 

0,0,  , . , 

27 

1 1 1 1 1 

1 

cib; 

Til 

Z.1  , . 

— 

.1.1^ 

• . 

7.<i.  . . . 

28 

. , , , , 

V. 

TTrr' 

SS.1.L1 

• ^ 

0,0,  , , . 

29 

1 

L.A.BPfl 

, ,13 

• 

1 1 1 1 

30 

1 1 1.  1 1 

1 

1 

1 1 1 

F.E.R.T. 

. . H 

• 

0,0,  , , , 

31 

1 

1 . I 

Lo.TiC.T 

. , ,1 

• 

0.0,  , , , 

32 

1 1 1 1 1 

1 

1 1 1 

i/.R.C.b.T 

. , ./ 

• 

oa  , , , 

33 

1 1 1 1 1 

\l 

1 

< 

1 1 1 

L.B.C.0.7 

, , J 

• 

^0,  , , , 

34 

_i  1 1 1 1 1 

1 

c,< 

5; 

T.n 

£1  . . 

. , .3,L 

• 

S>il.  . . . 

38 

15. bill 

• 

0.0.  . . . 

JOB  NO. 


DATE 

NAME  ^ y 


SHEET 


OF 


CD-S2 
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c , Agenda 

The  Agenda  for  this  example  consist  of  five  Agendum  cards  as 
follows,  V7ith  punching  starting  in  card  column  one. 

HEADING  USDA  LP/90  EXAMPLE  1 SINGLE  LP  PROBLEM 

INPUT , 1 , , COUNTS ,REWIND 

CONTROLS  30 

NORlilL 

OUTPUT 

The  first  of  these  is  a simple  instruction  to  print  the  comments 
in  card  columns  13  to  72  at  the  top  of  each  output  page.  This  message 
actually  is  printed  in  BCD  on  the  O-tape  in  the  appropriate  places.  But 
when  the  latter  is  listed  under  “program  control"  the  heading  will  appear 
on  each  page  of  the  output  listing. 

The  second  Agendum  card  instructs  LP/90  to  (1)  read  the  I~tape 
(as  shown  in  Table 20  above),  (2)  convert  it  to  binary,  (3)  prepare  a 
special  analysis  on  the  elements  of  the  matrix  which  is  helpful  for 
checking  purposes  (COUNTS),  and  (4)  rewind  the  I-tape  when  done.  The 
"1"  following  "INPUT,"  indicates  that  a single  objective  function  row  has 
been  input  in  the  LP  matrix.  The  two  commas  follov/ing  the  "1"  indicate 
that  the  first  job  on  the  I-tape  is  to  be  processed.  If  a number  were 
placed  between  these  commas,  that  number  of  complete  sets  of  input  (=  to 
the  number  of  EOF  cards)  would  be  skipped  before  processing. 

The  CONTROLS  card  is  used  to  determine  the  amount  of  printed 
output,  the  frequency  of  reinversion,  and  certain  other  control  information. 
Reinversion  may  be  thought  of  simply  as  a round-off  error  correction  and  speed 
procedure  in  the  NORMAL  algorithm,  I7e  have  specified  that  this  round-off 
error  correction  take  place  every  30  iterations.  By  leaving  the  rest  of 
the  card  blank  we  have  specified  the  minimum  of  output ; namely,  an  on 
line  message  every  10th  iteration,  an  off  line  message  every  iteration 
and  a full  iteration  print  on  the  final  iteration  (which  gives  the  optimal 
solution).  The  reader  may  consult  Part  V for  other  optional  uses  of  this 
card. 
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The  NORMAL  card  calls  for  the  solution  of  the  LP  problem  prepared 
by  INPUT  from  the  I-tape  and  now  in  binary  on  the  A-tape.  NORMAL  does 
not  use  the  I-tape,  but  the  binary  A-tape,  prepared  by  the  preceding 
INPUT  Agendum.  Finally,  OUTPUT  instructs  LP/90  to  prepare  the  solution 
information  in  BCD  on  the  0-tape  for  off  line  listing. 

These  Agendum  cards  are  placed  in  the  card  reader  and  the  I-tape 
mounted  on  tape  unit  Bl.  The  machine  operator  then  pushes  the  "Load 
Tape"  button  and  LP/90  proceeds  to  follow  the  instructions  as  specified, 
producing  at  the  end  the  desired  0-tape. 

All  of  these  Agendum  items  used  in  this  example  are  on  the  SHARE 
LP/90  System,  as  well  as  on  USDA  LP/90. 


d . Output 

The  listing  of  the  0-tape  yields  four  pages  of  output.  These  are 
reproduced  exactly  in  Table  21,  except  that  the  first  three  pages  of  output, 
which  consume  only  a few  lines  each,  have  been  overlapped  so  as  to  consume 
less  space.  The  page  numbers  are  at  the  right-most  part  of  the  heading 
line.  The  heading  read  in  by  the  HEADING  Agendum  does  indeed  appear  at 
the  beginning  of  each  new  page,  as  advertised. 

Consider  now  the  output  page  by  page.  The  two  lines  following 
the  heading  line  are  meaningless  for  the  two  first  pages.  Their  use  should 
be  obvious  in  the  discussion  below  of  output  pages  3 and  4,  The  fourth 
print  line  on  page  1 is  merely  the  second  Agendum  card  as  read  from  the 
card  reader.  The  fifth  line  gives  the  time  that  the  INPUT  Agendum  began 
processing.  This  time  was  780.89  minutes  since  midnight.  The  title  card 
on  the  I-tape  is  printed  next. 

Output  page  2 presents  the  output  produced  by  the  COUNTS  option 
on  the  INPUT  Agendum.  This  output  gives  (1)  the  number  of  non- zero 
elements  in  each  row  of  the  LP  matrix  (exclusive  of  the  right-hand- side) , 
and  (2)  the  number  of  non-zero  elements  in  each  column  of  the  LP  matrix 
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and  in  the  proper  slack  vectors  created  automatically  by  INPUT  (as 
specified  on  the  row  identification  cards).  Including  the  cost  rov7, 
there  are  18  rows  in  the  LP  matrix.  Including  the  slack  vectors,  there 
are  34  vectors  (the  slacks  are  given  names  corresponding  to  the  active 
constraint  rows).  In  all  there  are  612  (=  18  x 34)  possible  entries, 
but  only  113  non-zero  elements.  The  ratio  of  the  non-zero  elements  to  the 
total  number  of  possible  entries  gives  the  matrix  "density"  of  18%. 

As  LP  problems  go  this  is  a fairly  "dense"  problem,  densities  of  about 
5%  being  common, 

and 

On  page  3 the  CONTROLS /xNORMAL  Agendum  cards  are  printed  as  read, 
and  the  time  when  the  NORMAL  Agendum  began  printed.  The  time  elapsed 
from  the  beginning  of  INPUT  to  this  point  is  ,13  minutes,  or  7,80  seconds! 

The  last  line  shov7S  information  about  the  iteration  on  which  the  feasible 
solution  was  found:  a feasible  solution  was  found  on  the  sixth  iteration, 

the  value  of  this  feasible  solution  is  $41,328,610,  During  this  iteration 

24/ 

column  1SBG21  replaced  the  slack  vector  + LBSBG  in  the  basis, — 

On  page  4 the  results  of  the  final  optimal  solution  are  displayed. 

The  optimal  solution  was  achieved  on  the  16th  iteration  and  the  value  of 
the  optimal  solution  is  $83,187.85.  The  computation  was  completed  at 
time  781,06  with  the  elapse  of  .04  minutes,  or  2,40  seconds! 

The  full  solution  print  follows  the  iteration  information.  The 
J(H)  column  identifies  the  variable  (column)  name  in  the  optimal  basis 
and  the  BETA(H)  column  gives  the  value  of  each  non-zero  primal  variable  in 
the  optimal  (basic)  solution.  The  ROU(l)  column  gives  the  row  identification 
for  each  row  in  the  matrix,  the  PI(I)  column  gives  the  optimal  dual 
variable  (marginal  value)  corresponding  to  each  constraint  element  in 
the  right-hand- side,  and  finally  the  B(I)  column  gives  the  right-hand- 
side  elements  or  constraint  vector  for  the  problem.  (The  number  one  found 
opposite  the  objective  function  row  in  the  PI (I)  column  indicates  not  a 
marginal  value  or  dual  variable,  but  merely  the  row  of  the  LP  matrix  that 
was  minimized. 

Table 22  summarizes  the  solution  (rounded  to  hundreds)  including 
the  implied  zero  values  for  the  non-basis  variables.  There  were  eight 
non-zero  process  levels,  corresponding  to  exactly  eight  non-zero  marginal 
values.  The  slack  variables  give  the  amount  of  unused  capacity.  A positive 

— / For  a discussion  of  bases  see  Part  II,  Section  5,d. 
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slack  means  a "loose  constraint"  and  zero  dual  variable.  A zero  slack 
means  a tight  constraint  and  a positive  dual  variable.  The  reader  can 
easily  verify  that  the  value  of  the  primal  solution  equals  the  value  of 
the  dual  solution  by  multiplying  the  dual  variables  by  their  respective 
right -hand- side  elements  and  adding  cumulatively.  He  then  see  confirmed 
in  this  example  the  duality  theorem  summarized  in  Part  II  above  and  we 

are  left  with  no  doubt  that  IP/ 90  has  indeed  given  a desired  optimal 

25  / 

solution. — 


o c / 

—'Where  the  optimal  solution  is  nonunique,  IP/ 90  gives  only  one 
such  solution. 
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Table  22;  Summary  of  the  Optimal  Solution  of  Single  LP  Example 


Process 

Name 

Acres  Planted 
(Process  Level) 

Constraint 

Name 

(Slack  Name) 

Marginal  Value 
(Dual  Variable) 

Amount  Unused 
(Slack  Var) 

ICOTll 

0 

SOIL  1 

28.44 

0 

1C0T12 

274.37 

SOIL  2 

2.09 

0 

1C0T21 

398.75 

LABP  4 

0 

3181.50 

1C0T22 

0 

FERT 

13.04 

0 

2C0T11 

0 

LOTCT 

34.17 

0 

2C0T12 

26.88 

LOTRC 

90.54 

0 

2C0T21 

0 

UBCOT 

0 

180.00 

2COT22 

0 

UBOAT 

0 

102.00 

lOATll 

0 

UBSBG 

22.63 

0 

10ATX2 

0 

UBALF 

0 

78.00 

10AT21 

418.00 

UBRIC 

0 

70.00 

10AT22 

0 

LBCOT 

0 

60.00 

ISBGll 

46.75 

LBOAT 

0 

122.00 

1SBG21 

603.25 

LBSBG 

0 

280.00 

lALFll 

152.00 

LBALF 

4.78 

0 

1RIC21 

0 

LBRIC 

0 

1.00 

1RIC22 

80.00 

S2COT 

4.54 

0 

'7 


ill 


e.  Remarks 

While  the  real  speed  of  USDA  LP/90  can  be  appreciated  fully  only 
in  the  computation  of  large  problems,  it  is  still  impressive  to  observe 
that  the  entire  computation  time  for  this  run  was  about  ten  seconds. 

This  includes  both  the  conversion  of  the  I- tape  to  binary  and  the  problem 
solution.  The  fact  that  sixteen  iterations  took  only  2.40  seconds,  or 
.15  seconds  per  iteration,  is  indicative  of  what  the  user  can  expect  on 
larger  problems. 

This  time  could  have  been  further  reduced  by  omitting  the  COUNTS 
option  from  the  INPUT  Agendum  control  card.  It  was  used  here  for  illustrative 
purposes.  The  information  produced  by  this  option  (page  2 of  the  output 
listing)  is  very  useful  for  "debugging"  a model  and  its  data.  For  example, 
a solution  might  have  been  obtained  that  was  patently  ridiculous.  Such 
a result  might  have  occurred  simply  because  a single  matrix  element  card 
was  inadvertently  omitted  when  the  I-tape  was  prepared.  This  error  could 
be  immediately  discerned  by  examining  the  COUNTS  output. 


2.  MULTIPLE  LP  PROBLEMS 

a.  Purpose 

The  solution  of  several  LP  problems  during  the  same  computer  run 
is  illustrated  in  this  example.  A PROP  Agendum  routine  that  allows 
modification  of  an  existing  I-tape  is  used. 

b.  Data 

The  data  for  this  example  include  all  of  the  data  used  in 
Example  1,  plus  an  additional  objective  function,  and  two  additional 
PvHS  or  Constraint  Vectors.  Table  23  shows  the  augmented  LP  matrix  to  be 
used.  This  table  is  identical  to  Table  18  except  that  the  new  objective 
function  row  bZ2bbb  has  been  inserted  and  two  new  right-hand- sides 
appended  at  the  right. 


LP  MATRIX  FOR  MULTIPLE  LP  EXAMPLE 
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c.  Agenda 


Four  separate  LP  problems  will  be  solved  in  this  run.  First,  the 
Z1  objective  function  is  maximized  using  the  2nd  RHS.  Second,  the  Z2 
objective  function  is  maximized  using  the  2nd  RHS.  Third,  the  Zl 

objective  function  is  maximized  using  the  3rd  RHS.  Finally,  the  Z2 

objective  function  is  maximized  using  the  3rd  RHS.  The  complete 

Agenda,  including  the  I-tape  "correction"  routine  is  listed  in  Table  24. 
Each  of  its  Agendum  control  cards  will  now  be  discussed  in  turn. 

The  first  of  these  is  already  familiar.  The  second,  CORRECT. BCD, 
is  a PROP  routine.  It  enables  us  to  ammend  the  I-tape  created  for  the 
preceding  run  (Section  1)  during  the  computer  run,  saving  the  need  to 
re-card-to-tape  the  augmented  data.  The  "B7"  following  the  Agendum  name 
(note  the  decimal  in  the  latter)  informs  the  computer  that  it  will  find 
the  I-tape  to  be  "corrected"  on  cape  unit  B7,  The  new  augmented  I-tape 
is  to  be  iTritten  on  tape  unit  Bl,  The  corrections  are  read  from  the 
card  reader  (CR) , We  shall  avoid  interpreting  the  entry  "4"  until  we 
come  to  Section  5,  The  REWIND  causes  all  of  the  tapes  to  be  rewound. 

The  original  I-tape  is  unloaded  and  can  be  dismounted  during  the  run. 

This  Agendum  card  is  follov/ed  by  a series  of  cards  which  it  uses  as  Input. 
If  the  "CR"  entry  on  the  Agendum  card  had  contained,  let  us  say,  A7  the 
correction  cards  would  have  been  read  from  tape  unit  A7. 

The  first  card  of  the  group  following  CORRECT. BCD  is  MATCH, 7, 18. 
This  card  tells  the  Agendum,  that  in  searching  for  changes  in  the  I-tape 
it  should  conq>are  only  card  colxmins  7 through  18.  (These  Include  the 
row  and  column  name  fields.)  The  next  card  says  search  until  you  find 
a card  with  Zl  in  column  14  and  15.  The  next  card  says  insert  the  new 
record  found  on  the  card  following.  After  the  Z2  card  which  will  be 
inserted  as  a row  identification  for  the  iiev/  objective  function  to  be 
inserted,  comes  a match  card.  When  this  card  record  is  found  on  the 
I-tape  the  card  following  the  INSERT,  1 card  is  inserted,  and  so  on. 

In  general,  the  number  following  the  INSERT,  gives  the  number  of 
card  images  to  be  inserted  on  the  new  I-tape  following  the  preceding 
card  used  for  matching. 
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By  comparing  the  data  for  CORRECT. CCD  against  Table  20,  the  reader 
can  see  that  we  have  effected  the  entry  of  the  new  objective  function 
elements  in  each  column  of  input  data,  and  the  new  RHS  elements  after 
the  original  Right-Hand-Side,  Table  25  shows  the  listing  of  the  new 
I-tape  created  by  this  Agendum  from  the  old  I- tape  and  the  new  card  data. 

Following  CORRECT. BCD  is  the  INPUT  Agendum  control  card.  Its 
appearance  is  the  same  as  in  Example  1 except  that  a ”2"  replaces  '*!” 
following  the  Agendum  name.  This  is  because  our  new  I-tape  contains  tx/o 
objective  function  rows. 

The  CONTROLS  Agendum  is  the  same  as  before.  Note  that  it  appears 
only  once  in  the  Agenda  even  though  four  separate  problems  are  solved. 

This  is  because  the  control  parameters  set  by  it  remain  the  same  until 
a nex7  CCOTROLS  Agendum  or  a new  INPUT  Agendum  is  encountered.  The  latter 
always  resets  the  control  parameters  to  their  programmed  values  so  that 
CONTROLS  should  always  follow  INPUT  if  control  parameters  different  than 
the  programmed  values  are  desired. 

The  asterisk  in  the  NORMAL  cards  indicates  that  objective  function 
row  names  rather  than  numbers  are  to  be  used.  Optionally  the  NORMAL 
cards  could  have  been  punched  as  follows  v/ith  exactly  the  same  result. 

NORMAL, 0,2  or  NORMAL, , 2 

NOR14AL,l,2 

NORMAL, 0,3 

NORMAL,!, 3. 

The  row  number  on  an  LP  matrix  begins  X7ith  zero.  The  first  objective 
function  is  given  a row  index  of  zero,  the  second  row  index  of  one,  and 
so  on.  In  Example  1,  no  rox/  or  right-hand- side  index  was  given  because 
the  first  (and  only)  one  was  used. 

Note  that  all  of  the  Agendum  routines  in  this  example  --  except 
CORRECT. BCD  — are  SHARE  routines.  The  exception  is  a PROP  or  Proprietary 
Routine. 
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Table  25: 

Listing  of  I-Tape  Created  by  Correct.  BCD 

♦ tiso>t 

t Listing  Sheet  1) 

(Listinj 

IHFU  T 

LT'  IT  2COTIZ  SOILT 

1.00 

ROW  ID 

2COT12  FERT 

4,00 

Zl 

2C0T12  LOTCT 

1.00 

Z2 

2COT12  UBCOT 

1.00 

+ 

SOILl 

-?COTir -LBCOT- 

liOO 

+ 

SOIL2 

2COT12  S2COT 

6.51 

♦ 

LABP4 

2COT21  Zl 

42.52 

FERT 

2COT21  Z2 

47.05 

LOTCT 

2C0T21  S0IL2 

1.00 

+ 

LOTRC 

2COT21  LOTCT 

1.00 

+ 

UBCOT 

2C0T21  tlBCOT 

1.00 

+ 

UBOAT 

2COT21  LBCOT- 

1.00 

UBSBG 

2COT21  32C0T 

2.73 

+ 

UBALF 

2COT22  Zl 

71,60 

UBRTC 

- 2C0T22  22 

74,64 

+ 

LBCOT 

2COT22  S0IL2 

1.00 

♦ 

LBO  AT 

2COT22  FERT 

^.t>o 

+ 

LBSBG 

2COT22  LOTCT 

1.00 

+ 

LBALF 

2CQJ22  UBCOT 

1,00 

+ 

LBRIC 

2C0T22  LBCOT- 

1.00 

■¥ 

S2COT 

2COT22  S2C0T 

4.89 

MATRIX 

lOATll  Zl 

3,80 

ICOTll 

Zl 

35.16 

— -rOATtl  Z2 

6,81 

ICOTll 

Z2 

48.16 

lOATll  SOILl 

1.00 

ICOTll 

SOILl 

1.00 

- - - lOATll  UBOAT 

1.00 

ICOTll 

LABP4 

5.80 

lOATll  LBOAT- 

1,00 

ICOTll 

LOTCT 

1.00 

10AT12  Zl 

30.63 

ICOTll 

UBCOT 

1.00 

10AT12  Z2 

36.12 

ICOTll 

LBCOT- 

1.00 

10AT12  SOILl 

1.00 

1C0T12 

Zl 

114.79 

10AT12  FERT 

4.00 

1COT12 

Z2 

119.59 

10AT12  UBOAT 

1.00 

1COT12 

SOILl 

1.00 

10AT12  LBOAT- 

1,00 

1COT12 

LABP4 

13.50 

10AT21  Zl 

2.09 

1COT12 

FERT 

4.00 

10AT21  Z2 

5,11 

1COT12 

LOTCT 

1.00 

10AT21  S0IL2 

1,00 

1COT12 

UBCOT 

1.00 

10AT21  UBOAT 

1,00 

1COT12 

LBCOT- 

1.00 

10AT21  LBOAT- 

1.00 

1COT21 

Zl 

36.26 

10AT22  Zl 

21.45 

1COT21 

Z2 

42.40 

10AT22  Z2 

30.17 

1COT21 

SOIL2 

1.00 

10AT22  S0IL2 

1.00 

1COT21 

LABP4 

5.50 

10AT22  FERT 

4.00 

1COT21 

LOTCT 

1.00 

10AT22  UBOAT 

1.00 

1COT21 

UBCOT 

1.00 

10AT22  LBOAT- 

1.00 

1COT21 

LBCOT- 

1.00 

ISBGll  Zl 

51,07 

1COT22 

Zl 

57.05 

ISBGll  Z2  - 

65,87 

1COT22 

Z2 

64.38 

ISBGll  SOILl 

1.00 

1COT22 

SOIL2 

1.00 

ISBGll  LABP4 

1.10 

1COT22 

LABP4 

8.30 

ISBGll  UBSBG 

1.00 

1COT22 

FERT 

4,00 

ISBGll  LBSBG- 

1.00 

1COT22 

LOTCT 

1.00 

1SBG21  Zl 

24,72 

1COT22 

UBCOT 

1.00 

1SBG21  Z2 

33,27 

1COT22 

LBCOT- 

1.00 

1SBG21  SOIL2 

1,00 

2COT11 

Zl 

42.13 

1SBG21  LABP4 

1.10 

2COT11 

Z2 

46.93 

1SBG21  UBSBG 

1,00 

2COT11 

SOILl 

1.00 

1SBG21  LBSBG- 

1,00 

2COT11 

LOTCT 

1.00 

lALFll  Zl 

23,66 

2COT11 

UBCOT 

1.00 

lALFll  Z2 

34.52 

2COT11 

LBCOT- 

1.00 

lALFll  SOILl 

1,00 

2COT11 

S2COT 

2.79 

lALFll  LABP4 

0.70 

2COT12 

Zl 

144.33 

lALFll  UBALF 

1.00 

2COT12 

Z2 

138,98 

lALFll  LBALF- 

1,00 
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1RIC21 

Z1 

60.91  



T.BCOT-  6^0. 

1RIC21 

Z2 

55.32 

C3 

LBOAT-  296. 

1RIC21 

SOIL2 

1.00 

C3 

LBSBG-  370. 

1RIC21 

LOTRC 

1.00 

C3 

LBALF-  152. 

1RIC21 

UBRIC 

1.00 

C3 

LBRIC-  79. 

1RIC21 

LBRIC- 

1.00 

C3 

S2COT  175. 

1RIC22 

Z1 

144.81 

EOF 

1RIC22 

Z2 

117.93 

1RIC22 

SOIL2 

1.00 

1RIC22 

FERT 

4.00 

1RIC22 

LOTRC 

1.00 

1RIC22 

UBRIC 

1.00 

1RIC22 

LBRIC- 

1.00 

FIRST  B 

Cl  SOILl  500, 

Cl  S0IL2  1500* 

Cl  LABP4  9900. 

Cl  FFRT  1525. 

Cl  LOTCT  700. 

Cl  LOTRC  80. 

Cl  UBCOT  880. 

Cl  UBOAT  520. 

Cl  UBSBG  650. 

Cl  UBALF  230. 

Cl  UBRIC  150. 

Cl  LBCOT-  640. 

Cl  LBOAT-  296. 

Cl  LBSBG-  370. 

Cl  LBALF-  152. 

Cl  LBRIC-  79. 

Cl  S2C0T  175. 

NEXT  B»2 

C2  SOILl  1500. 

C2  SOIL2  500. 

C2  LABP4  9900. 

C2  FERT  1525. 

C2  LOTCT  700. 

C2  LOTRC  80. 

C2  UBCOT  880. 

C2  UBOAT  520. 

C2  UBSBG  650. 

C2  UBALF  230. 

C2  UBRIC  150. 

C2  LBCOT-  640. 

C2  LBOAT-  296. 

C2  LBSBG-  370. 

C2  LBALF-  152. 

C2  LBRIC-  79. 

C2  S2COT  175. 

NEXT  B.3 

C3  SOILl  1500. 

C3  SOIL2  500. 

C3  LABP4  9900. 

C3  FERT  1525. 

C3  LOTCT  5000. 

C3  LOTRC  5000. 

C3  UBCOT  880. 

C3  UBOAT  520. 

C3  UBSBG  650. 

C3  UBALF  230. 

C3  UBRIC  150. 
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d , Output 

The  output  for  this  example  is  like  that  for  Example  1,  except 
there  is  more  of  it.  An  abridged  listing  of  the  output  appears  on  the 
next  four  pages  (Table  26).  The  first  of  these  presents  page  3 of  the 
Output  listing  containing  the  results  of  the  COUl'ITS  option.  Note  that 
the  nex7  rov/  appears  with  its  17  elements,  and  that  each  column  (except 
the  slack)  has  an  additional  element.  Thus,  COUNTS  gives  us  a quick 
check  on  x^hether  or  not  CORRECT, BCD  inserted  the  correct  number  of  cards. 

The  Agendum  routine  TITLE  causes  pages  to  be  renumbered  starting 
X7ith  one,  so  that  the  page  numbers  of  the  full  solution  print-outs  are 
not  in  ascending  order.  The  four  Output  pages  containing  the  four  full 
LP  solutions  are  reproduced  tx7o  per  page  in  Table  26 * The  solutions  are 
summarized  in  Table  27  . The  first  problem  required  15  iterations  to  gain 
the  optimal  solution,  problem  2 required  only  one  iteration.  This  is 
because  the  second  NORMAL  begins  X7ith  the  existing  solution  in  core,  and 
the  optimal  basis  is  the  same  for  both  problems.  The  optimal  solution 
for  the  3rd  problem  x/as  obtained  in  11  iterations  and  the  fourth  in  one, 
for  the  same  reason  as  in  problem  2. 
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Table  27:  Summary  of  the  Four  Optimal  Solutions 

(Primal  Variables  Only) 


Process 

Name 

Problem  1 

Problem  2 

Problem  3 

Problem  4 

ICOTll 

0 

0 

170.75 

20.75 

1C0T12 

274.37 

354.37 

204.37 

354.37 

1C0I21 

398.75 

318.75 

350.00 

350,00 

1COT22 

0 

0 

0 

0 

2C0T11 

0 

0 

0 

0 

2COT12 

26.88 

26.88 

26.88 

26,88 

2COT21 

0 

0 

0 

0 

2C0T22 

0 

0 

0 

0 

IQATll 

318.75 

238.75 

296.00 

296.00 

10AT12 

0 

0 

0 

0 

10AT21 

21.25 

101.25 

0 

0 

1QA.T22 

0 

0 

0 

0 

ISBGll 

650.00 

650.00 

650.00 

650.00 

1SBG21 

0 

0 

0 

0 

lALFll 

230.00 

230.00 

152.00 

152.00 

1RIC21 

0 

80.00 

0 

150.00 

1RIC22 

80.00 

0 

150.00 

0 

Value 

101,311,01 

116,839.15 

105,671.96 

120,073.82 
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e . Remarks 

The  running  time  for  the  complete  example  was  about  a minute. 

Of  this,  CORRECT. BCD  consumed  a little  over  half.  INPUT  consumed 
about  10  seconds.  The  first  solution  required  1.8  seconds,  the  second 
.72,  the  third  2.83  and  the  fourth  .72  seconds.  The  balance  of  the 
time  was  devoted  to  OUTPUT  and  reading  of  Agendum  routines  from  the 
system  tape. 

The  proportionately  long  time  devoted  to  CORRECT, BCD  illustrates 
a basic  principle  of  LP/90  (as  well  as  other  scientific  computer  programs) 
computation.  The  internal  computing  speed  is  far  faster  than  tape  pro- 
cessing speed.  Even  though  this  Agendum  has  very  little  computing  per  se 
to  do,  it  does  have  quite  a bit  of  tape  to  read.  At  a cost  of  (approxi- 
mately) $500.00  per  machine  hour  the  cost  of  CORRECT, BCD  in  this  example 
was  about  $5,00.  The  entire  run  cost  about  $8,00.  In  some  cases  it  will 
be  preferable  to  make  the  corrections,  insertions  or  deletions  from  the 
original  card  deck,  and  to  use  the  off-line  card  to  tape  to  create  the 
new  I-tape.  Ordinarily  this  would  be  the  least  expensive  of  the  two 
options.  On  the  other  hand,  under  some  conditions  it  will  be  a great 
convenience  and  time  saver  to  use  the  CORRECT, BCD  Agendum  to  create  the 
new  I-tape.  Thus,  the  user  must  balance  cost  against  time  saved  when 
using  CORRECT. BCD  [note  also  that  many  corrections  can  be  made  by  REVISE], 

In  general,  there  are  certain  economics  of  scale  in  LP/90,  The 
search  for  and  reading  of  Agendum  routines  from  the  Operations  tape  are 
really  an  overhead  cost.  As  the  size  of  the  problem  increases  this  sub- 
sidiary processing  consumes  less  and  less  time  relative  to  the  time  spent 
on  simplex  iterations.  Correspondingly,  all  of  the  input  processing  and 
output  processing  Agendum  routines  consume  a disproportionately  large 
amount  of  time  on  tiny  LP  problems  such  as  those  included  in  this  study. 

On  problems  with  hundreds  of  rows  and  columns  their  use  involves  a 
negligible  cost  relative  to  the  LP  computations  themselves.  The  latter 
do  of  course  increase  more  or  less  exponentially  with  the  number  of  rows. 
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3.  WRITING  REPORTS 

a.  Purpose 

By  now  the  use  of  the  Agendum  concept  should  be  familiar.  The 
Agendum  Routine  is  simply  a special  computer  sub-program  stored  on  the 
Operations  tape  and  called  into  play — at  the  user*s  option — by  an  Agendum 
control  card.  The  particular  LP  and  LP  related  computations  have  been 
organized  in  the  form  of  Agendum  routines  in  LP/90.  And,  as  we  saw  in 
the  preceding  example  where  CORRECT. BCD  was  employed,  any  specialized 
computation  can  be  adapted  to  this  kind  of  usage. 

It  is  the  purpose  of  this  example  to  illustrate  the  use  of  two  of 
the  most  ingenious  and  generally  useful  of  all  the  Agendum  routines. 

They  are  the  PROP  (Proprietary)  routines  COMPILE  and  REPORT.  Like 
CORRECT. BCD  these  routines  do  not  perform  LP  computations.  The  former 
was  useful  primarily  to  facilitate  timely  and  convenient  correction  of 
input  data  for  LP  computations.  On  the  other  hand,  COMPILE  and  REPORT 
are  designed  to  facilitate  interpretation  and  convenient  summarization 
of  the  output  from  LP  computations. 

b.  Data 

The  data  for  this  example  is  identical  to  the  I- tape  created 
in  Example  2.  He  shall  in  fact  perform  a duplicate  of  Example  2 except 
that  COMPILE  will  be  used  at  the  beginning  of  the  run  and  REPORT  after 
each  use  of  NORMIL.  Thus,  there  will  be  four  LP  problems  solved  and  the 
solution  output  will  be  identical  to  that  output  in  Example  2.  Howfever, 
we  shall  assume  that  the  actual  magnitude  of  the  right -hand- sides  is 
just  1000  times  as  great  as  the  RHS  elements  on  the  I-tape.  He  could 
then  regard  the  I-tape  model  as  a typical  firm  possessing  1/1000  of  a 
given  region* s resources.  The  Agendum  routine  REPORT  will  be  made  to 
scale  our  solution  variable  by  1000,  so  as  to  convert  the  data  to  regional 
totals. 

The  new  I-tape  created  by  the  use  of  CORRECT. BCD  in  the  last  example 
provides  the  I-tape  for  this  problem.  This  input  corresponds  of  course 
to  the  LP  matrix  illustrated  in  Table  23, and  the  I-tape  listing  in  Table  25* 
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c.  Agenda 

The  complete  Agenda  for  this  example  is  listed  in  Table  31.  The 
Agenda  for  this  example  is  just  like  that  for  example  2,  except  that 
COMPILE, CR, B8, 1 appears  after  the  HEADING  card  and  is  followed  by  program 
cards  up  to  and  including  END***,  and  the  Agendum,  REPORT, B8,l,  follows  each 
of  the  four  NORMAL  Agendum  control  cards.  Also,  as  the  new  I- tape  from 
example  2 is  used,  the  CORRECT. BCD  Agendum  is  deleted. 

The  COMPILE, CR, B8, 1 instructs  LP/90  to  (1)  read  the  cards  in  the 
card  reader  (CR)  up  to  and  including  the  END***  card.  (These  cards 
constitute  a report  writing  program.)  (2)  Compile  the  program  in  machine 
language.  (3)  Store  it  on  tape  unti  B8  as  report  writing  program  number  1. 
The  REPORT, B3,1  card  says  to  (1)  read  in  report  writing  program  number 
1 on  tape  unit  B8  (as  placed  there  by  the  preceding  COMPILE);  (2)  process 
and  format  the  last  solution  on  the  mediary  output  tape  (M-tape  in  binary) 
and  place  the  resulting  report  on  the  O-tape  for  printing.  The  B8  tape 
can  be  saved  for  later  runs. 

In  order  to  fully  understand  the  use  of  these  Agendum  routines, 
we  shall  insert  a special  section  dealing  with  the  rules  of  their  application 
next.  Then  we  may  return  to  the  usual  section  on  output. 

COMPILE  and  REPORT  are  PROP  LP/90  routines.  The  remainder  belong 
to  the  SHARE  LP/90  system. 
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d.  How  to  Use  COMPILE 

26/ 

The  rules  for  coding — ' a report  writing  program  are  really  auite 
simple.  They  can  in  fact  be  summarized  on  a single  page  as  shown  in 
Table  28.  A special  COMPILE  card  format  sheet  is  used  to  code  the  program. 
Table  30  shows  a photographic  reproduction  of  the  first  page  of  the  report 
coding  form  used  in  this  example,  while  Table  31  shows  the  complete  listing. 
Rather  than  discuss  the  COMPILE  card  rules  in  general,  we  shall  instead 
explain  the  particular  COMPILE  cards  used  in  this  example.  In  doing  so 
we  shall  illustrate  the  steps  which  one  would  usually  pursue  in  preparing 
the  report  writing  program. 

Step  1:  Report  Layout.  As  in  report  writing  in  general,  the 
LP/90  COMPILE -REPORT  user  must  decide  (1)  just  what  he  wants  to  report, 
and  (2)  the  form  or  appearance  of  his  report.  In  a great  many  cases,  the 
LP  analyst  does  not  really  want  the  detailed  optimal  solution  as  produced 
by  OUTPUT.  Instead  he  wants  the  values  of  various  variables  that  are 
based  on  or  derived  from  the  optimal  solution.  Let  us  suppose  that  as 
agricultural  economists  we  do  not  really  need  to  know  how  much  cotton, 
oats,  etc.,  would  be  produced  by  each  and  every  process  in  the  optimal 
solution.  Rather,  we  are  interested  in  (1)  the  total  amount  of  each  crop 
produced,  (2)  the  amounts  produced  on  each  soil  type  and  (3)  the  amounts 
produced  at  each  level  of  fertilization.  We  could  think  of  other  equally 
interesting  kinds  of  information,  but  these  will  serve  to  illustrate  the 
procedure . 

Having  decided  on  the  information  we  wish  to  derive  from  the 
optimal  solution,  the  report  layout  may  be  prepared.  This  task  is  greatly 
facilitated  by  using  a special  printer  spacing  chart  which  enables  the 
report  to  be  specified  exactly  as  it  will  appear  when  printed  from  the 
0-tape.  As  we  shall  see,  the  spacing  chart  also  facilitates  the  coding 
of  our  report  writing  program. 

The  spacing  chart  used  in  this  example  is  duplicated  in  Table  29. 

The  report  contains  three  tables  as  indicated  above,  and  in  our  case  they 
will  all  fit  nicely  on  a single  output  page.  Furthermore,  the  tables  have 


26/  By  coding  is  meant  the  writing  down  of  a series  of  instructions 
to  be  converted  to  machine  language  by  a computer  compiler  or  assembler. 
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been  spaced  so  that  when  the  output  is  received  the  sheets  can  be  trimmed 
for  binding  in  a standard  government  size  ring  binder. 

Step  2:  Coding  the  Report  Writing  Subprogram.  Rather  than 

itemize  the  application  of  the  coding  rules  to  each  card  in  the  Report 
IJriting  Program,  we  shall  instead  list  for  each  of  the  23  cards  the 
effective  instruction  tiiat  corresponds  to  the  punched  statement.  By 
comparing  this  list  against  Table  28  , which  presents  the  general  CC1*IPILE 
Card  Format  rules,  the  reader  will  see  how  the  report  layout  is  converted 
into  a series  of  program  statements. 


Compile  Card 
Card  1 


Effective  Instruction 

Scale  each  primal  solution  variable  (column  names 
ICOTll,  ...,  1R1C22)  and  each  slack  variable  by  1000. 


Card  2 


Begin  a new  page  of  the  report  with  the  solution  heading 
(read  in  by  HEADING  or  TITLE  Agenda)  and  number  page  on 
the  first  line. 


Card  3 
Card  4 


Place  the  name  of  the  report  after  double  spacing. 

Place  the  column  headings  of  the  first  report  in  the 
designated  columns. 


Card  5 Continue  card  4. 

Card  6 Double  space  and  print  name  of  first  rov/  (COTTON  LINT)  of 

table , 


Cards  7-14  Compute  the  cumulative  total  of  production  for  cotton,  by 
multiplying  each  yield  (constant)  by  the  solution  variable 
for  the  process  (column  name)  with  that  yield j and,  having 
done  that,  place  the  answer  to  the  left  of  card  column  40; 
place  a comma  in  betv/een  every  three  digits  to  the  left  of 
column  40;  and  suppress  the  decimal  point.  Do  not  space 
(i.e.,  place  on  same  print  line  as  COTTON  LINT). 
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Effective  Instruction 

Compute  total  acreage  in  cotton  as  the  upper  bound  for  cotton 
(UBCOT)  minus  the  slack  variable  for  this  row  (+UBCOT),  and 
place  answer  to  the  left  of  column  60,  Insert  commas  and 
suppress  the  decimal  point. 

Obtain  the  average  yield  for  all  cotton  processes  by  dividing 
total  production  by  total  acreage  and  place  the  answer  with 
tx7o  places  to  right  of  decimal  point  in  card  column  80. 

Place  name  of  second  row  of  table  after  double  spacing. 

Compute  the  cumulative  production  for  cotton  seed  by 
multiplying  each  cotton  seed  yield  by  the  corresponding 
solution  variable,  etc. 

With  these  examples,  the  reader  may  return  to  the  listing  of  the  complete 
Agenda  and  see  how  the  program  is  continued. 

Step  3 : Checkinr:  the  Codinr>  for  Errors.  It  is  important  for  the 

coder  to  check  the  report  writing  program  for  errors,  (1)  He  should 
first  check  his  coding  sheet  carefully,  making  sure  that  exactly  the  right 
symbol  is  indicated  in  the  proper  column  and  that  all  LP  Matrix  data 
referred  to  are  identified  in  the  coding  by  exactly  the  same  row  and  column 
names  as  used  on  the  I-tape,  (b)  The  punched  cards  should  be  carefully 
checked  against  the  coding  forms.  A common  error  is  the  punching  of  "ohs" 
for  “zeros"  or  vice  versa.  In  column  1 of  the  Cd-IPIIiE  Card  Format  a zero 
is  used  to  indicate  double  spacing.  An  "oh"  in  this  column  will  cause  a 
CCa-IPILE  error  message, 

Uhile  this  exegesis  is  not  exhaustive,  the  reader  can,  by  studying 
the  material  presented  here,  gain  a basic  understanding  of  how  report 
^nriting  programs  are  prepared. 


Compile  Card 
Card  15 


Card  16 


Card  17 
Cards  18-23 
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TABLE  28 

COMPILE  CARD  FORMAT 


Col.  1 


Col.  2 


Col.  3 


Printer  Control 

1 = New  Page  b = Single  Space  (b  = blank) 

0 E Double  Space  + = No  Space 

Card  Type 

H = Hollerith  text,  col.  3-72  are  in  print  line. 

C = Continuation  card,  limited  to  one  continuation  card  if 

Hollerith  text  in  which  case  col.  13-60  continues  the  text. 
T = Title;  begin  new  page,  problem  heading  and  page  number  on 
first  line. 

Blank 


Col.  4 Z E Suppress  line  if  all  computed  values  are  zero.  Should  be 

used  only  on  the  first  card  calling  for  computation  in  a 
line . 


Col.  1-6 


vr /vTc 

END  terminates  loading  of  Compile  Cards. 


Col.  5-9 


Format 


Col.  5-9 
Col.  5-7 
Col.  8 


Col.  9 


blank  means  do  not  print. 

decimal  point  position  in  print  line. 

decimal  point  or  comma.  If  comma,  commas  will  be 

inserted  to  mark  the  thousands  place  in  values. 

positions  to  the  right  of  decimal  point.  (if  0, 
the  decimal  is  suppressed.) 


Col.  10-15  New  Variable  Name 

Any  alphanumeric  symbol  allowed,  up  to  6 characters.  The 
symbol  is  used  as  in  Fortran,  e.g.,  XI  = C 5.  followed  by 
XI  = C 17.  is  legal.  XI  will  have  the  value  5 between  the 
first  and  second  defining  statements. 


Col.  16,  25,  etc.  Operator 

+ E add  / = 
- E subtract  = = 
" = multiply  S = 


divide 

equals  (may  be  used  in  col.  16  only) 
Scale  all  variables  of  kind  indicated 
in  type  field.  The  scale  factor  is 
written  in  Constant  format  in  the  name 
field  following  the  op.  More  than  one 
scale  can  be  given  on  one  card.  It 
must  be  the  very  first  card  of  deck 
if  used. 
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Ti\BLE  28:  COMPILE  CARD  FORIUT 


Col.  17,  26,  etc.  Operand  Type 

X = Beta  (Primal  Variable,  use  col.  name) 

P = Pi  (Dual  Variable,  use  row  name) 

B = Right-Hand  Side 

D = D/J  (will  be  computed  during  REPORT) 

A = a^  from  matrix 

" J 

C E Constant 

N = New  variable  previously  defined  in  column  10-15  (at  its 
current  value) 

M = Objective  function  values.  (From  Beta  region  identified 
by  row  name . ) 

Col.  18,  27,  etc.  Slack  type  for  indicating  slack  variables.  For  betas 
this  column  must  be  or  blank.  For  all  other  types  of 

operands  this  must  be  blank.  Exception;  Constant  values  must 
begin  in  this  column. 

Col.  19-24,  28-33,  etc.  Name  of  Operand;  if  this  is  a new  variable  it  must 
have  been  defined  sometime  previously  in  col.  10-15. 

Note  1;  Arithmetic  operations  are  of  the  form: 

( ( (=X^) opX^) opX^)  where  quantities  on  left  are 

operated  on  by  the  next  succeeding  quantity  on  the 
right  and  are  thereby  redefined  for  the  next  succeeding 
operation. 

Note  2:  If  type  field  is  A,  then  the  corresponding  name  field 

is  the  column  name  and  the  next  contiguous  (cannot  be 
on  next  card)  name  field  is  the  row  name  defining  the 
element . 


Table  29:  PRINT  SPACING  CHART 
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Table  30:  REPORT  CODING  FORM 

LINEAR  PR06RAMMINe  OUTPUT  REPORT  M«.  ^0^0 

INPUT  FORM  (COMPILE  CARDS)  D«U  I S' Tune  Hi'S 

LP-90  - INPUT  FORM  C — 

Pr«g!  D^y 


133 


3 

CO 


CN 


m 

- 

- 

_ 

..  . 

- 

— 

--'  ■' 

— 

“ * 

— 

— > 

•K 

Ui 

Ua 

— ' 

NAME 

1 

3dAi 

O 

S 

< 

z 

VU 

vij 

MJ 

-Q+  1 

3dAl 

'S) 

Oo- 

2 

< 

Z 

- 

>K 

- - 

-0+  1 

3dAl 

'9 

Oo- 

NAME 

V- 

s- 

£} 

za 

L. 

-J 

-J 

to 

vO 

1- 

i- 

s- 

V-* 

J=L 

0-. 

lO 

lO 

IO 

r 

IO 

u 

• O 

::5 

o 

O 

3 

•o 

o- 

o 

as 

o 

XS" 

^?r 

✓> 

<x. 

d. 

VO 

~a: 

to 

1 

*<? 

Jr 

9dAi 

s) 

-z 

_s 

% 

O 

3r 

4- 

.4- 

+- 

4- 

4. 

-F- 

■*- 

•f- 

4- 

4- 

4- 

NAME 

O 

■«4 

ni 

ns 

x+ 

o4 

-t 

ri 

«4 

ni 

rt 

« 

vq 

M 

o# 

Ol 

oS 

IO 

io 

«-D 

oi 

-«4 

o 

QC 

V- 

w 

V- 

•- 

i- 

1- 

1- 

K 

V- 

1— 

1— 

t:t 

o 

to 

lO 

to 

lO 

lO 

lO 

iQ 

io 

1-0 

|o 

•O 

IO 

Io 

io 

o 

o 

o 

o 

O 

o 

-O 

o 

r«> 

O 

O 

ni 

ns 

1 

<? 

-*- 

3dAl 

«Q 

X 

X 

X 

Oo- 

V 

1 

s 

-•If 

-Mt 

-Dfp 

•air 

NAME 

fn 

'V. 

Ov 

U 

V- 

>■ 

0^ 

• 

o» 

>S 

Ov 

lO 

'ki 

nt 

^7 

'«>» 

o 

’O 

1— 

. 

, 

In  •' 

o 

to 

<>t 

CO 

«Q 

*Q 

ns 

o 

Cs 

cs 

o 

5> 

“?5 

O 

o 

“?5 

— - 

<s 

- ca 

«:? 

o 

ev. 

W 

~«5 

o 

J3+  1 

->i 

H 

o 

O 

S 

s.^ 

G 

Su 

o 

•o 

3dAi 

Uj 

O 

O 

KJ 

o 

O 

oq 

z 

V 

V) 

O o- 

o. 

If 

II 

ii 

li 

II 

II 

II 

If 

(f 

II 

ii 

•I 

II 

ii 

If 

IT 

NEW 

VARIABLE 

lO 

V- 

u 

1- 

O 

-J 

J 

-ki 

-i 

o 

IO 

VJ 

'0 

V7 

• 

_Jr 

1 — 

V- 

1- 

t:: 

1- 

lO 

lo 

lO 

lO 

o 

IO 

lO 

' ^ 

t<3L 

lO 

t;) 

3 

'0 

O 

O 

to 

50 

VI 

o) 

et- 

3 

O 

t/1 

Ok 

V? 

O- 

SO 

of. 

a. 

V 

Oir 

FORMAT 

o 

o 

— 

— 

Q 

ct 

* <1 

oq 

rUh- 

h- 

<J 

- ^ 

L»Z»- 

O 

■4- 

+- 

4- 

4- 

4- 

-4- 

4- 

4- 

4- 

4- 

*4— 

+-  1 4- 

+- 

4- 

— 'o  ^ t« 


^ ^ \ ^ «x 


(T  ■§ 


134 


CO  CO  CO 

CO  CO 

CO 

CO 

CO 

CO 

CO 

CO 

CO  CO  CO  CO 

CO 

CO 

CO 

CO 

CO 

CO 

CO  CO  CO  CO  CO 

CO 

CO 

CO 

jo 

c*> 

CO 

CO 

CO  CO  CO 

CO  CO  jo  CO 

CO  CO  CO 

CO  CO  CO 

CO 

CO  CO  CO 

CO 

CO 

tu  iLI  UJ 

UJ  hJ 

bJ 

bJ 

UJ 

UJ 

bJ 

bJ 

bJ  bJ  bJ  bJ 

bJ 

bJ 

bJ 

UJ 

UJ 

bJ 

bJ  bJ  bJ  UJ  bJ 

a 

a 

a 

fu 

to  a a 

a 

a 

a a a 

a a a a 

a a a 

a a a 

tu 

a 

a a a 

a 

a 

-J  u _l 

-J 

-i 

-j 

-J 

-1 

-J 

-1  U -J  U 

-J 

-J 

-1 

^ ^ U -1  ^ 

-j 

CO  ^ _J 

;-j 

_) 

_J  _j  -J 

u ^ P ^ 

-J  -J  J 

-J  ^ -J 

_j 

^ ^ 

-J 

-1 

CL  b.  a 

a D. 

Q. 

a 

a 

0. 

a 

Q. 

a D.  O.  (L 

a 

a 

a 

a 

a 

a 

a a a a a 

a 

a 

a 

a 

a a 

a 

a 

a a a 

a a a a a a a 

a a a 

a 

a 

a a a 

a 

a 

X s:s:  X T 

Z 

z; 

X 

X 

z: 

Z 

z z z z 

z 

z 

z 

z 

z 

X 

z z z z z 

z 

z 

z 

•d-  Z Z 

z 

z 

z z z 

z z z z 

z z z 

z z z z 

z 

z z z 

z 

z 

< «s  < 

< < 

< 

< 

< 

< 

< 

< 

< < < < 

< 

< 

< 

< 

< 

< 

< < < <r  < 

< 

< 

< 

•-C  < < 

< 

< 

< < < 

« <«  < 

< < < 

< < < 

< 

< 

< < < 

< 

< 

X X K 

X X 

X 

X 

X 

X 

X 

X 

X X X X 

X 

X 

X 

X 

X 

X 

X X X X X 

X 

X 

X 

X 

XXX 

X 

X 

XXX 

X X X X 

XXX 

XXX 

X 

X 

XXX 

X 

X 

lu  bJ  bJ 

bJ  bJ 

bJ 

bJ 

bJ 

bJ 

UJ 

UJ 

UJ  a bJ  bJ 

UJ 

UJ 

bJ 

bJ 

bJ 

UJ 

bJ  bJ  a bJ  bJ 

a 

a 

a 

bJ 

to  a a 

a 

a 

a a a 

lu  UJ  iu  tu  iu  UJ  UJ 

a a a 

a 

a 

a a a 

a 

a 

> 

< 


a, 

a 

ni 

X 

W 


o 

a 


bJ  (M 

Q. 

>-  -I 
t- 

O 

to 


QO  K 

bJ 


< rH  #-(  t-t  t-f 


< 

+ a 


o o 
u u 

CM  CM 

>C  X 
+ + 


a z 

z 

o 

z 

o 

z 

o z 

z 

o 

z 

o 

z 

o 

z 

z 

< 

z 

z 

z 

bJ 

o 

c 

Q 

f-H 

h-  O 

=) 

u 

D 

CJ 

Z) 

u 

Z3 

D 

a 

3 

a 

3 

a 

3 

3 

o 

3 

3 

3 

a 

u 

u 

CfH 

Z>  — 

to 

a 

to 

a 

to 

a 

iO 

to 

a 

to 

a 

to 

a 

to 

to 

a 

to 

to 

a 

a 

rH 

CSJ 

u 

V 

4) 

o »- 

< 

aS 

CO 

u 

z 

z 

z 

z 

z 

z 

z 

z 

z 

z 

z 

z 

z 

z 

z 

z 

z 

z 

z 

X 

X 

T3 

X 

a 

D 

+ 

+ 

+ 

+ 

+ 

+ 

+ 

+ 

+ 

+ 

+ 

+ 

+ 

+ 

+ 

+ 

+ 

+ 

+ 

+ 

+ 

<D 

iw 

c 

CO 

o 

O 

c-i  CM 

CM 

CM 

CM  t- 

z 

r-l  CM 

»-i 

CM 

CM 

r-c 

CM 

z 

i-i 

CM 

rH 

CM 

K 

rH 

a 

fH 

|H  CM 

u 

a 

o 

CNJ 

CM 

CM 

CM 

00 

u 

• 

o 

rH  r-C 

CM 

CM 

CM 

CM  O 

o 

rH  rH 

CM 

CM 

CM 

CM 

o 

c-C 

CM 

CM 

< 

to 

rH 

CM 

CO 

CM  CM 

•-I  IU 

o 

t/) 

rH 

(M 

rH 

CM 

a 

c 

a 

h-  t- 

h- 

t- 

*- 

t- 

t- 

u 

»- 

1-  K 

►- 

h- 

t- 

h- 

t- 

K 

h- 

t- 

h- 

h- 

O 

a 

a 

a 

a 

u 

a a 

a a a 

♦- 

h- 

h- 

^i4 

z 

o 

a 

o o 

o 

o 

o 

o 

o 

O CD 

o 

O O 

o 

o 

o 

o 

O 

o 

o 

< 

< 

< 

< 

00 

< 

m 

CO 

CD 

CD 

-1 

•»!  r-4 

to  •-> 

a 

c 

o 

o 

< 

< 

U 

< 

o 

u u 

u 

u 

u 

a 

u 

a 15 

a 

a a 

a 

a 

a 

a 

a 

a 

a 

o 

o 

O 

O 

3 

o 

to 

to 

3 

a 

< 

a a 

3 a 

u 

u 

o 

o 

o 

CD 

X X 

X 

X 

X 

X 

X 

X X 

z 

X X 

X 

X 

X 

X 

X 

X z 

X 

X 

X 

X 

X 

z 

X 

X 

X 

z 

X 

X X 

X Z 3 

X 

X 

z 

X 

X 

z 

a 

* * 

* 

* 

* 

* 

* 

* 1 

■V. 

♦ * 

* 

♦ 

* 

* 

♦ 

♦ 

* 

* 

♦ 

* 

• 

v 

♦ 

* 

1 

■fe 

♦ ♦ 

1 ^ 

UJ 

+ 

+ 

+ 

+ 

+ 

+ 

o 

o a 

<o 

a 

O' 

rH 

a 

O'  h- 

»- 

O'  CM 

•* 

a 

h- 

O' 

>d- 

O Z Cs 

o 

o 

o 

o 

t- 

o 

o 

a 

r- 

rH  fH 

o o 

a 

rH 

rH 

rH 

rH 

• 

rH  CM 

O' 

"O 

a 

a 

O'  o 

(M  tr\ 

o 

a 

a 

o 

a 

® O a 

rd- 

rH 

c^ 

rd- 

< 

a 

o 

o 

CD 

c 

rH  O 

a a 

•H  UJ  u. 

rH 

CM 

rH 

CM 

o 

o 

• • 

• 

• 

• 

• 

• 

• a 

»- 

• • 

• 

• 

• 

• 

• 

• »-  K 

• 

• 

• 

• 

o 

t- 

• 

• 

a 

ej 

• 

U • 

• • 

a a 

*- 

h- 

1- 

h- 

o 

a 

CM 

CM 

a 

CM 

a to 

O 

m (M 

a 

fH 

•d- 

rH 

■d- 

a o O 

■d’ 

a 

CM 

eo 

CD 

< 

O' 

r- 

CD 

(D 

CM 

_l  CM 

fH  a 

CD  r-. 

o 

O 

z 

< 

< 

z 

•V 

o 

K O O 

o 

o 

O 

o 

O 

o rs 

a o o »-• 

o 

o 

o 

rH 

o 

o a a 

rH 

a 

rH 

a 

3 

o 

CM 

fH 

3 

CO 

O 

< O 

rH  CO 

3 O' 

a 

a 

3 

o 

o 

3 

a 

rH 

c z o o 

o 

o 

o 

o 

C5 

o 

0. 

UJ  o o 

o 

o 

o 

o 

o 

o < a 

o 

o 

o 

c 

a 

o 

o 

a 

O 

rH  O 

o o 

a 

rH 

rH 

a 

rH 

rH 

a 

-J 

o 

J 

•H  O O 

o 

o 

o 

o 

O 

o 

u o o 

o 

o 

o 

o 

o 

o 

o 

c 

o 

o 

o 

o 

o 

O 

o o 

X 

UJ 

-J  a a 

a 

a 

a 

a 

a 

a CD 

z 

a a a 

a 

a 

a 

a 

a 

a z z 

a 

a 

a 

a 

CD 

z 

a 

a 

a 

CD 

z 

a 

X a 

a a 

CD  Z 

,x 

X 

z 

X 

X 

z 

< 

a 

a 

U N 

N 

H 

H 

H 

M 

M a 

u 

• n 

H 

u 

H 

a 

n 

a a II 

a 

a 

n 

a 

a 

a 

z 

a 

a 

a 

H 

< 

a 

H a 

a a 

a D 

a .J 

u 

H 

a 

a 

a 

a 

O rH 

o >-  z »- 

1— 

1- 

c-  z 

z o 

o 

o 

o 

< 

u 

o < 

z 

a • 

a 

O -J 

-1 

_l 

-J  O 

o a 

a 

a 

a 

a 

a 

a 

bJ 

-) 

UJ  UJ 

a •-  o 

3 ® 

a 

t-  1- 

»- 

t- 

c-  *- 

t-  t- 

>- 

t- 

c- 

a 

1- 

1- 

*- 

CD 

a 

a 

< 

bJ 

a a 

a o »- 

a 

m 

• 

z o 

z 

o 

z 

o 

z 

O O 

X o 

z 

o 

z 

o 

z 

o 

t-  z 

< 

z 

< 

< 

>-  z 

CD 

CD 

u 

a Z rn 

#H 

»-  z 

o 

t-  z 

O 

• 

o 3 a 

3 

a 

3 

a 

3 a a 

o 3 a 

3 

a 

3 

a 

3 

a 

< 3 

o 

3 

o 

o 

O 3 

a 

a 

_J 

►r  3 CC 

a 

O 3 

o 

< 3 

a 

a 

a a a 

a 

a 

a 

a 

a a < 

a a a 

a 

a 

a 

a 

a 

a 

o a 

a 

a 

a 

< 

a a 

a 

< 

< 

a a a 

< 

a 

a 

< 

o «o 

< 

a 

o o 

CM 

O O CM 

o 

o 

CM 

o 

o 

CM 

o 

O CM 

o 

O CM 

o 

o 

c 

o 

o 

o 

r r 

» r r 

» 

r 

• 

r 

•> 

r r 

r 

* r 

•> 

r 

* 

• 

* 

r 

a bj 

O C 

OD 

O O CD 

c 

O 

® 

o 

O 

00 

o 

O W 

O 

O ® 

o 

O 

o 

o 

o 

O 

Z 

o a 
5* 

hJ  o 

<d-  a 

h- 

4-  a K 

•d- 

a 

tH 

>d- 

a 

•d- 

a 

■d- 

a h- 

H*- 

a 

CO 

rd- 

a 

® 

t- 

1 1 a 

I 

I 

X 

X 

I 

X 

X 

X a X 

X 

z a 

o o 

C+  + 

+ 

+ 

+ 

+ 

+ 

+ + 

+ o + + 

+ 

+ 

+ 

+ 

+ 

+ + + 

o 

+ 

+ 

+ 

+ 

+ 

+ 

o 

+ 

+ 

+ 

+ o 

+ 

+ + 

+ 

+ 

0 

+ + 

o 

o 

o 

+ 

+ 

+ o 

+ 

■f 

+ 

135 


SCO  fo  en 
tij  iLi  LU  bJ  Uj 

^ O.  0>  CL  ^ £1> 

r X X s r 

< < c < < 

X X X X X 
iij  Lu  uj  tij 


f 


cn  CO  CO 
UJ  LU  fu 
-i  ^ -i 

a a a 
XXX 
< < < 
XXX 
kJ  liJ  tiJ 


fO  ^ CO  CO 

ti  I yj  Qj  jj  > 

•J  ^ ^ 

a a a a 

X X X X 
< < < < 
X K X X 
lu  lu  tu  bj 


eo  CO  CO 
UJ  iu  UJ 

u u ^ 
a a a 
XXX 
< < < 
XXX 
UJ  iu  UJ 


C 


CO  CO  CO 
UJ  |U  UJ 


a a a a 

X X X X 
< < < < 
X X X X 
UJ  tu  UJ  tu 


CO  CO 
UJ  UJ 
•J  -I 

a a 

X X 
< < 
X X 
UJ  tu 


CO  CO  CO 

UJ  UJ  UJ 
pj  ^ u 

a a a 

X X X 
< < < 
XXX 
Uj  Ui  tu 


bJ 

> 

bJ 

CM 

a -j 
tu  UJ 
fsl  > 
»— • bJ 


CM 

4J 

0> 

4) 

j: 

CO 

00 

c 

•H 

■U 

(0 


•»4 

fH  CM 

»- 

CM  CM 

#-* 

CM 

CO 

'4' 

a 

bJ 

o o 

a 

X 

X 

X 

X 

CM  CM 

a 

a 

a 

a 

•J 

u 

>- 

X X 

a 

CD 

CD 

CD 

OD 

+ + 

o 

o 

C 

O 

CM 

a 

a 

a 

a 

iH  r-t 

a 

a 

a 

a 

UJ 

o 

< 

bJ 

a 


i«-  I- 

o c 
u u 

CM  CM 


o 

CO 


u;  a 

X X 

CO 

CO 

CO 

CO 

< > 

-f 

rH 

a 

CM 

u» 

a 

»H  CM 

rH 

CM 

UJ 

a 

a 

a 

a 

04 

CM 

♦—1 

CM  CM 

CM 

CM 

u 

iD 

< 

u a 

a 

»-  f- 

►- 

K 

a 

a 

a 

a 

a 

CD 

CD 

►H 

a 

c 

o o 

o 

< 

< 

o 

a 

X 

X 

X 

X 

c/) 

D 

a 

a 

KJ  U 

o 

o 

o 

o 

3 

< 

< 

< 

< 

rH 

u> 

fH  rH 

< 

rH 

rH 

< 

X 

X 

X 

X 

+ 

+ 

a 

a 

a 

a 

X 

X 

X 

X 

X X 

z 

X 

X 

z 

X 

•f 

1 

? 

o 

+ + 

+ 

+ 

+ 

+ 

1 

r-»  »-M 

rH 

a 

<-H  UJ 

rH  CM 

rH 

CM 

rH  CM  UJ 

i-l  CM  fH 

rH 

CM 

•-< 

a 

«-H  rH 

rH 

rH 

CM  CM  *-• 

e>  e>  o 

a 

< 

u a 

♦-  »- 

1— 

UJ  a a 

o 

o 

o 

o 

CD  CD  CD 

CD 

U»4 

a 

a "V 

o o 

X 

< 

< 

X 

r«<  r>f  CD 

O' 

O' 

O' 

c^ 

CO  10  U) 

< 

15 

a 

r> 

o u 

3 

o 

o 

3 

a a 3 

'V 

X 

V 

>s 

rH  f-H 

rH 

rH 

rH  rH 

to 

rH 

rH 

to 

rH  rH 

a 

a 

a 

a 

-j 

iO  X X X 

X 

ffi 

X 

a 

X X 

z 

X 

X 

z 

X X a 

Z N It  H 

< 

II 

U 

fi 

H 

a 

fl  M 

« 

H 

fl 

U H H 

< CM 

< 

CM 

< 

CO 

< CO 

< 

a 

o < 

z 

o 

o ♦ 

o 

o 

o • 

a 

a ♦- 

o 

z 

a 

to 

to 

to 

CD 

< 

a 

u o 

h- 

to 

a 

r^4 

3 

3 

3 

3 

>- 

a 

KJ 

H-  X O 

K X 

O 

u 

2 

o 

«j 

ri 

0 3 0 

< 3 

o 

r-i 

a 

rH 

rH 

CM  rH 

rH  rH 

CM  rH 

U) 

< 

a 

U CO  < 

O CO 

< 

a 

a 

fsJ 

?M 

fsJ  r 

o o o 

- 

o 

o 

o 

o 

o o 

o 

o 

o 

o 

o o o 

a 

a 

a 

a 

«k  * 

«> 

* 

* 

• • 

» 

* 

* 

«k 

• » «k 

» CO 

a 

♦ 

a 

« a 

« a 

o o o 

o 

o 

o 

o 

o o 

o 

o 

o 

o 

o o o 

CM  J 

'4'  00 

'4' 

00 

v£> 

00 

sf  >0 

a 

'4- 

a 

•4-  ^0  a 4c 

♦ O 

-J  1- 

-J  t- 

-J  »- 

H-  a 

a < a 

a < a 

a < a 

a < a 3 

♦ 

3 ♦- 

-JXC-JXO^XO 

-J  X o a 

o a z 

»-  a a 

h>  a a H a a 

t-  a a K 

I 

X 

X 

X X u> 

•X 

X 

X 

z 

r o 

•-*  o a 

o a 

*— < 

O a 

•-«  C a 3 

O 4 -t-  + O 

+ 

o 

•f 

o o 

o 

-f  + 

+ o 

-I' 

+ o 

+ + + a 

f-i  UJ 

»~za»-zai-za 

1-  z a o 

136 


e . Output 

The  reports  -produced  by  each  use  of  the  REPORT  Agendum  are  found 
first  on  the  0-tape,  After  the  reports  come  the  usual  output  created  by 
the  OUTPUT  Agendum,  As  the  latter  is  ( for  this  example)  exactly  like 
that  produced  in  example  2,  v/e  shall  not  present  it  here.  The  reports, 
hov/ever,  are  reproduced  in  Table  32,  They  are  reproduced  exactly  as 
printed  from  the  0-tape  except  that  they  have  been  trimmed  to  a more 
convenient  size. 
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Table  32:  OUTPUT  FROM  REPORT  AGENDUM 


(Listing  Sheet  1) 


USDA  LP/90 

EXAMPLE  3 

PROBLEM  1 

OUTPUT 

SUMMARY 

CROP 

/ 

PRODUCTION 

ACREAGE 

AVE  YIELD 

COTTON  LINT 

3,338,983 

700,000 

4.77 

COTTON  SEED 

5,688,035 

700,000 

8.13 

OATS 

4,864,125 

340,000 

14.31 

SOYBEANS 

18,850,000 

650,000 

29.00 

ALFALFA 

476,100 

230,000 

2.07 

RICE 

2,848,000 

80,000 

35.60 

FIELD 

CROP  ACREAGE 

BY  SOIL  TYPE 

CROP 

/ 

SOIL  1 

SOIL  2 

TOTAL 

COTTON 

301,250 

398,750 

700,000 

OATS 

318,750 

21,250 

340,000 

SOYBEANS 

650,000 

650,000 

ALFALFA 

230,000 

230,000 

RICE 

80,000 

80,000 

FIELD  CROP  ACREAGE 

BY  FERTILIZER  LEVEL 

CROP 

/ 

LEVEL  1 

LEVEL  2 

TOTAL 

COTTON 

398,750 

301,250 

700,000 

OATS 

340,000 

340,000 

RICE 


80*000 


80,000 
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Table  32:  OUTPUT  FROM  REPORT  AGENDUM- -Continued 


(Listing  Sheet 

2) 

USOA  LP/90 

EXAMPLE  3 

PROBLEM  2 

OUTPUT 

SUMMARY 

CROP  / 

PRODUCTION 

ACREAGE 

AVE  YIELD 

COTTON  LINT 

3,680,583 

700,000 

5.26 

COTTON  SEED 

6,270,435 

700,000 

8.96 

OATS 

4,744,125 

340,000 

13.95 

SOYBEANS 

18,850,000 

650,000 

29.00 

ALFALFA 

476,100 

230,000 

2.C7 

RICE 

1,408,000 

80,000 

17.60 

FIELD 

CROP  ACREAGE  BY  SOIL  TYPE 

CROP  / 

SOIL  1 

SOIL  2 

TOTAL 

COTTON 

381,250 

318,750 

700,000 

OATS 

238,750 

101,250 

340,000 

SOYBEANS 

650,000 

650,000 

ALFALFA 

230,000 

230,000 

RICE 

80,000 

80,000 

FIELD  CROP  ACREAGE 

BY  FERTILIZER  LEVEL 

CROP  / 

LEVEL  1 

LEVEL  2 

TOTAL 

COTTON 

318,750 

381,250 

700,000 

OATS 

340,000 

340,000 

RICE 

80,000 

80,000 
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Table  32:  OUTPUT  FROM  RFPORT  AGFJN DU M- -Continued 


(Listing  Sheet  3) 


USDA  LP/90 

EXAMPLE  3 

PROBLEM  3 

OUTPUT 

SUMMARY 

CROP  / 

PRODUCTION 

ACREAGE 

AVE  YIELD 

COTTON  LINT 

3,217,908 

752,000 

4.28 

COTTON  SEED 

5f483,203 

752,000 

7.29 

OATS 

4,262t400 

296,000 

14.40 

SOYBEANS 

18.850.000 

650,000 

29.00 

ALFALFA 

314,640 

152,000 

2.07 

RICE 

5,340.000 

150,000 

35.60 

FIELD 

CROP  ACREAGE 

BY  SOIL  TYPE 

CROP  / 

SOIL  1 

SCIL  2 

TOTAL 

COTTON 

402,000 

350,000 

752,000 

OATS 

296,000 

296,000 

SOYBEANS 

650,000 

650,000 

ALFALFA 

152,000 

152,000 

RICE 

150,000 

150,000 

FIELD  CROP  ACREAGE 

BY  FERTILIZER  LEVEL 

CROP  / 

LEVEL  1 

LEVEL  2 

TOTAL 

COTTON 

520,750 

231,250 

752,000 

OATS 

296,000 

296,000 

RICE 

150,000 

150,000 
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Table  32:  OUTPUT  FROM  REPORT  AGENDUM--Continued 


(Listing  Sheet  4) 


USDA  LP/90 

EXAMPLE  3 

PROBLEM  4 

OUTPUT 

SUMMARY 

CROP  / 

PRODUCTION 

ACREAGE 

AVE  YIELD 

COTTON  LINT 

3,837,408 

752,000 

5.10 

COTTON  SEED 

6,537,703 

752,000 

8.69 

OATS 

4,262,400 

296,000 

14.40 

SOYBEANS 

18,850,000 

650,000 

29.00 

ALFALFA 

314,640 

152,000 

2.07 

RICE 

2,640,000 

150,000 

17.60 

FIELD 

CROP  ACREAGE 

BY  SOIL  TYPE 

CROP  / 

SOIL  1 

SOIL  2 

TOTAL 

COTTON 

402,000 

350,000 

752,000 

OATS 

296,000 

296,000 

SOYBEANS 

650,000 

650,000 

ALFALFA 

152,000 

152,000 

RICE 

150,000 

150,000 

FIELD  CROP  ACREAGE 

BY  FERTILIZER  LEVEL 

CROP  / 

LEVEL  1 

LEVEL  2 

TOTAL 

COTTON 

370,750 

381,250 

752,000 

OATS 

296,000 

296,000 

RICE 

150,000 

150,000 

f , Remarks 
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The  time  used  by  COMPILE  was  about  25  seconds  at  a cost  of  about 
$3.50.  Each  use  of  report  took  about  9 seconds  at  a marginal  cost  of 
about  $1.25  each.  Even  on  the  tiny,  heuristic  problem  used  here,  this  is 
surely  a smaller  cost  than  having  a clerk  process  the  output  solution 
tape  into  comparable  table  form  and  having  a typist  complete  the  job. 

Of  course,  it  took  some  time  to  code  the  report  writing  program,  to  key 
punch  and  verify  it.  Yet,  in  the  very  frequent  type  of  LP  run,  with 
many,  perhaps  dozens,  of  individual  problems  run,  each  of  which  may  have 
hundreds  of  columns  and  rov/s,  this  cost  and  effort  v/ill  be  amply  repaid. 

The  fact  that  LP  output  can  be  processed  into  tables  of  direct 
interest  for  economic  analysis  in  a way  that  short-circuits  time-consuming 
and  error  producing  transformations,  intermediate  computation,  and  table 
formating,  greatly  enhances  the  usefullness  of  U*/90.  It  makes  model 
results  immediately  available  for  analysis  or  decision  making.  Uhen  the 
number  and  size  of  problems  are  very  large,  COMPILE  and  REPORT  may 
reduce  a clerically  burdensome  and  expensive  analysis  into  a modest  task 
of  photographing  and  suitably  duplicating  the  final  tables. 

CCX-IPILE  and  REPORT  are  particularly  convenient  for  use  in 
Recursive  Linear  Programming  runs,  when  a sequence  of  recursively 
dependent  LP  problems  are  solved.  This  kind  of  application  V7ill  be 
reviewed  in  Section  6 below. 
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4.  PARAMETRIC  PROGRAMMING 


a.  Purpose 

Parametric  objective  function  (price  mapping)  and  parametric 
right -hand- side  (resource  mapping)  computations  are  among  the  most 
frequently  used  of  the  LP-related  computations.  In  this  example 
several  different  parametric  programming  computations  are  performed. 

The  use  of  price  mapping  to  obtain  (comparative  static)  output  supply 
and  variable  input  demand  functions  is  illustrated.  Also,  resource 
mapping  for  proportional  changes  among  several  right-hand- side  elements 
is  exemplified,  Ue  also  take  this  opportunity  to  introduce  tv7o  additional 
PROP  input  modifyin<^  Agenda ^ one  for  adding  new  right -hand- side  elements, 
and  one  for  reading  an  initial  basis  from  which  to  begin  iterations. 


b.  Data 

The  input  data  ^;ith  which  we  began  in  example  1 was  augmented 
in  example  2 by  an  additional  objective  function  and  two  additional  RHS 
vectors.  For  this  example  \ze  augment  the  original  data  still  further  by 
the  addition  of  four  objective  function  "change  vectors"  and  two  right- 
hand-  side  "change  vectors," 

The  augmented  matrix  is  shox^n  in  Table  33.  In  this  example  the 
four  additional  matrix  rox/s  are  added  to  the  I-tape  created  in  example  2 
by  again  using  CORRECT. BCD,  After  its  use  the  I-tape  xjill  appear  as  shox/n 
in  Table  34,  The  tx/o  additional  right-hand- sides  to  be  used  for 
Parametric  LP  xi/ill  be  added  directly  to  the  A-tape  (binary  input  tape) 
after  the  use  of  INPUT  by  means  of  the  Agendum  ADDRHS . 

The  new  rox7s  added  to  the  data  are  (1)  a cotton  lint  yield 
coefficient  row  ICOTLT,  giving  the  yield  of  cotton  per  unit  process  level 
(per  acre)  for  each  cotton  grox7ing  process;  (2)  an  unskilled  labor 
coefficient  row  lUNSLB  giving  the  hours  of  unskilled  labor  used  per  unit 
process  level  (per  acre)  for  each  process;  (3)  the  negative  of  the  cotton 


143 


yield  row,  2C0TLT  and  (4)  the  negative  of  the  unskilled  labor  row,  2UNSLB. 
The  first  and  third  addition  will  enable  us  to  derive  a supply  function 
for  cotton;  the  second  and  fourth  item  will  enable  us  to  derive  a demand 
function  for  unskilled  labor. 

The  new  columns  will  not  appear  on  the  I~tape  but  will  be  placed 
on  the  A- tape  as  if  they  had  been  identified  as  NEXT  B,4  and  NEXT  B,5  on 
the  I-tape,  These  columns  are  (1)  the  values  of  the  RHS  elements  for 
the  upper  and  lower  bounds  (rows  beginning  with  UB  or  LB)  used  in  the 
first  RHS  vector  and  (2)  the  negatives  of  those  values.  All  of  the 
other  elements  are  zeros. 

The  first  of  the  two  in  effect  will  enable  us  to  raise  the  ut  per 
and  lower  bounds  proportionally  while  the  latter  will  enable  us  to  diminish 
them  proportionally  leaving  the  resource  stocks  and  acreage  allotmients 
unchanged.  While  this  type  of  change  might  be  economically  artificial  it 
is  presented  not  for  its  inherent  economic  interest  but  to  serve  as  an 
illustration  of  PLP  on  several  RHS  elements  simultaneiously . 
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c.  Agenda 

The  control  cards  comprising  the  Agenda  for  the  run  are  listed 
in  Table  35.  The  first  Agendum  after  HEADING  is  CORRECT. BCD  with  whose 
operation  we  are  already  familiar  (example  2).  The  cards  following 
MATCH, 7, 18  to  END***  are  used  by  this  routine  along  with  the  old  I-tape 
(from  example  2)  mounted  on  unit  B7,  to  create  a new,  augmented  I-tape 
on  Bl.  After  the  correct ion- -in  this  case  the  insertions  of  the  nex7 
cost  rows — the  nev;  I-tape  is  rewound  to  load  point.  The  INPUT  Agendum 
that  follows  may  now  operate  on  the  new  I-tape  converting  it  to  binary 
on  the  A- tape. 

The  PROP  Agendum  ADDRHS,CR  follows.  This  Agendum  has  not  been 
considered  heretofore  but  its  operation  is  straightforward.  The  right- 
hand-side  elements  to  be  added  are  read  from  the  card  reader  (CR) . These 
elements  follc«7  the  Agendum  card  and  include  the  END  card.  They  are  read, 
converted  to  binary  and  inserted  in  the  appropriate  place  on  the  binary 
A- tape.  The  A- tape  will  now  appear  just  as  if  it  had  been  created  solely 
by  INPUT  ftom  the  I-tape  when  the  latter  contained  the  newly  added  right- 
hand-  sides. 

Parametric  programming  is  always  performed  after  a given  optimal 
solution  has  been  found.  For  this  example  we  use  the  solution  of  example  1 
as  the  basic  solution.  Rather  than  perform  a NORMAL  using  the  first 
objective  function  and  first  RHS,  we  can  read  in  the  optimal  basis  as 
printed  on  the  final  solution  output  for  1 (Table  20) » This  is  done  x/ith 
the  PROP  Agendum  routine  NEW. BASIS.  The  tx/elve  cards  following  this 
Agendum  card  contain  the  names  of  the  columns  [J(H)  column  in  Table  20  and 
the  names  of  to\-js  ROW(I)  column  in  Table  20]  in  the  optimal  basis.  Not 
included  are  those  slack  columns  entered  opposite  the  rox-/  of  the  same 
name . 

The  reading  of  these  basis  heading  cards  is  terminated  by  the  next 
Agendum,  x/hich  must  be  INVERT.  This  Agendum  causes  the  inverse  of  the 
basis  just  read  in  to  be  computed  and  the  corresponding  solution  to  be 
derived.  As  the  latter  is  an  optimal  solution,  the  use  of  the  following 
NORMAL  is  (in  this  case)  a check  only,  but  must  be  present  in  order  to 
use  PLP  or  PCR, 
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The  CONTROLS  card  is  inserted  to  provide  a full  solution  print 
every  iteration  during  the  parametric  programming  computations. 

The  GET0FF,A7  is  an  Agendum  v/hich  we  have  not  encountered  before. 
Its  use  here  is  to  save  the  optimal  solution  we  just  reconstructed  so 
that  v/e  can  start  each  of  six  independent  parametric  programming 
computations  with  it.  The  routine  stores  on  tape  unit  A7  all  information 
necessary  to  reconstruct  the  current  solution.  This  information  is  called 
back  by  the  Agendum  RESTART ,A7.  Its  effect  is  to  restore  the  machine  to 
its  condition  following  the  NORMAL  Agendum. 

The  RESET  Agendum  that  follows  sets  the  change  parameter  (0  or  jD) 
used  in  parametric  programming  to  zero. 

DO.PCRjlCOTLT  performs  "price  mapping"  using  the  ICOTLT  row  as  a 
change  vector.  Similarly  for  the  next  three  applications  of  DO.PCR, 
mutatis  mutandis.  D0.PLP,4  and  D0.PLP,5  perform  "resource"  mapping  using 
the  fourth  and  fifth  right-hand- sides  (change  vectors)  found  on  the 
A-tape  respectively.  RESET  AND  RESTART  are  used  prior  to  each  parametric 
progranming  exercise  to  insure  beginning  at  the  original  optimal  solution. 

The  Agendum  Routines  CORRECT. BCD  and  ADDRHS  are  PROP  routines. 

The  remainder  are  SHARE  routines. 


HEADING  USDA  LP/90  EXAMPLE  4 PARAMETRIC  PROGRAMMING 

CORRECT. BCD. B7, B 1 ,CR» » 1 . »REW I ND 
match, 7. 18 
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d o Output 

The  output  for  this  series  of  six  parametric  programming  exercises 
is  quite  extensive,  and,  as  the  reader  is  by  now  already  familiar  with 
the  iteration  and  full  solution  print-outs,  it  would  serve  no  new  purpose 
to  reproduce  it  hereo  Instead  the  solution  print-outs  for  each  iteration 
are  summarized  in  Tables  36,  37,  and  38 <>  The  first  of  these  tables  gives 
the  results  of  the  first  two  (price  mapping)  exerciseso  The  first  three 
iterations  give  the  negative  branch  of  a cotton  supply  function  and  were 
computed  by  the  Agendum  DOoPCR,*ICOTLT.  The  next  three  iterations, 
computed  by  D0oPCR,*2C0TLT,  provide  the  positive  branch.  The  computatibns 
in  each  case  were  terminated  by  the  message  "PHI  UNBOUNDED"  which  means 
that  the  results  of  the  last  iteration  can  be  extrapolated  for  all 
greater  meaningful  values  of  0. 

Table  37  shows  corresponding  results  for  the  next  two  parametric 
LP  Agendum  cards.  These  give  a "demand  function"  for  unskilled  labor. 
Finally,  Table  38  gives  the  last  two  exercises. 

Figures  12  and  13  give  the  resulting  supply  curve  of  cotton  and 
demand  curve  for  unskilled  labor  respectively,  while  figure  14  shows 
graphically  the  results  of  the  "resource  mapping"  exercise. 
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Table  36:  Iteration  Summary  Giving  Cotton  Supply  Function 


Iteration 

Number 

Value 
of  0 

Corresponding 
Cotton  Price 
($/cwt.) 

Total 

Profit 

($) 

Cotton 

Acreage 

(Acres) 

Cotton 

Production 

(cwt.) 

Marginal  Value 
Cotton  Allot. 
($/acre) 

Negative 

Branch* 

0 

0 

35.00 

83,188 

700 

3338.98 

34.17 

1 

7.69 

27.31 

57,524 

700 

2167.43 

11.42 

2 

11.12 

23.88 

50,081 

700 

205^.77 

1.25 

3 

11.54 

23.46 

49,211 

640 

1875.17 

0.00 

Positive 

Branch** 

1 

7.43 

42.43 

107,992 

700 

3538.61 

56.16 

2 

41.03 

76.03 

226,886 

700 

3557.96 

155.61 

3 

42.93 

77.93 

233,661 

700 

3606.84 

161.25 

*Cotton  price  = 35.00  - 0. 
**Cotton  price  = 35.00  + 0. 


Table  37:  Iteration  Summary  Giving  Unskilled  Labor  Demand  Function 


Iteration 

Number 

Value 
of  0 

Corresponding 
Labor  Price 
($/hour) 

Total  Profit 
($) 

Labor  Demand 
(Hours) 

Positive 

Branch* 

0 

.00 

.34 

83,188 

81,359 

1 

.40 

.74 

50,673 

76,229 

2 

.42 

.76 

48,772 

55,020 

3 

.46 

.80 

46,907 

52,239 

4 

4.18 

4,52 

-147,503 

52,151 

5 

9.75 

10.09 

-437,984 

52,139 

6 

11.39 

11.73 

-523,401 

51,636 

7 

22.47 

22.81 

095, 763 

51,328 

Negative 

Branch** 

1 

.20 

.14 

99,383 

85,348 

.40 

-.06 

116,663 

89,041 

3 

2.34 

-2.00 

289,037 

89,939 

4 

117.64 

-117.30 

10,659,277 

89,939 

*Labor  price  =,34  + 0.  **Labor  price  = .34  - 0,  ***Iteration  in- 
cluding and  after  this  one  are  meaningless  for  a labor  price  cannot  be 
negative. 
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Table  33:  Iteration  Summary  Giving  "Flexibility  Response"  Analysis 


Iteration 

Value 

Total 

Cotton 

Cotton 

Number 

of  0 

Profit 

Production 

Acreage 

Positive  Branch 


0 

0 

83,188 

3338.98 

700 

0* 

,013 

83,364 

2228.98 

700 

Negative  Branch 

1 

.077 

82,109 

3338.98 

700 

2 

.205 

79,976 

3338.98 

700 

3 

.467 

67,222 

2656.21 

469 

4 

.630 

57,015 

2335.66 

326 

5 

.703 

49,993 

1871.97 

262 

6 

.716 

48,664 

1788.15 

250 

7 

.754 

43,846 

1545.59 

216 

8 

.781 

39,676 

1375.91 

193 

.969 

6,210 

175.00 

27 

*Infeasibility  occurs  at  0 = .01265823  without  change  in  original  optimal 
basis.  However,  profit  increases  because  of  increase  on  soybean  acreage 
at  expense  of  alfalfa, 

**Infeasibility  occurs  at  0 = 1.00  without  changing  optimal  basis  at 
iteration  9, 


Cotton  Production  (cwt. 
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FIGURE  12  : 

SUPPLY  FUNCTION  FOR  COTTON 


Thousands  of  Hours  of  Labor 
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FIGURE  13: 

DEMAND  FUNCTION  FOR  LABOR 


Production  of  Cotton  (Thousands  of  cwt 
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FIGURE  14:  PRODUCTION  OF  COTTON  AS  AFFECTED 

BY  PROPORTIONAL  CHANGE  IN  THE  FLEXIBILITY 
CONSTRAINTS 
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5.  LP  MATRIX  TRANSFORMATION 


a.  Purpose 

In  the  case  of  lar^e  scale  LP  models  the  preparation  of  the  L? 
matrix  data  may  constitute  an  excessive  amount  of  time  and  money.  As  the 
various  objective  function,  change  vector,  and  constraint  matrix 
coefficients  are  usually  formed  from  more  basic  price  and  technical  in- 
formation, the  natural  question  to  be  asked  is,  "TJhy  not  have  a program 
to  compute  these  coefficients  from  the  basic  data  as  well  as  have  one  to 
compute  the  LP  solution,"  That  is,  why  shouldn't  the  computer  participate 
in  preparing  data  for  a model  as  well  as  provide  the  model  solution? 

So-called  "matrix  generators"  have  been  developed  whose  purposes 
have  been  precisely  that  of  computing  the  LP  matrix  elements  from  more 
basic  data.  The  USDA  version  of  LP/90  does  not  contain  any  of  these 
"matrix  generators."  Hox7ever,  it  does  contain  an  Agendum  routine  v/hich 
performs  part  of  the  function  of  a matrix  generator,  and  which  can  be 
thought  of  as  a particular  variety  of  such  a program  species.  This 
USDA  Agendum  routine  is  called  TRANSFORM. 

TRANSFORM  multiplies  two  matrices  in  LP/90  I-tape  format  to  form 
a third  LP/90  A-tape,  It  thus  provides  a way  of  constructing  an  LP 
matrix  from  two  rather  more  basic  data  matrices,  or  of  modifying  an 
existing  LP  matrix  by  scaling,  recombining  or  deleting  certain  of  its 
rows. 

The  purpose  of  this  example  is  to  illustrate  one  of  the  various 
possible  uses  of  this  new  USDA  Agendum  routine.  In  doing  so  we  shall 
create  the  input  data  for  use  in  Example  6 on  Recursive  Linear  Programming. 


b , Data 

Just  as  we  did  in  the  preceding  exercises,  we  shall  begin  by 
augmenting  the  original  (Example  1)  model  data,  Tx7o  matrices,  sho^Tn  in 

Tables  39  and  40  will  be  used.  The  first  is  the  G Matrix,  the  second, 
the  T Matrix.  During  the  execution  of  the  Agendum  TRANSFORM  a third 

matrix,  the  H Matrix,  will  be  created.  It  is  the  latter  that  will 
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constitute  an  input  matrix  for  LP  solution.  The  former  two,  while  in  LP 
matrix  (I-tape)  form  will  not  constitute  meaningful  LP  matrix  data  by 
themselves. 


The  G Matrix:  The  G Matrix  includes  two  types  of  coefficients; 

(1)  the  technical  flow  coefficients  that  describe  how  much  of  each  output 
is  expected  per  acre  for  each  activity,  and  how  much  of  each  variable  input  is 
required  per  acre  of  each  activity;  and  (2)  the  constraining  coefficients 
that  describe  the  active  constraints  which  the  process  levels  must 
satisfy.  The  latter  have  been  fully  described  in  section  1 above  and 
sho\-7n  in  Table  18, 

The  former  are  arranged  in  rows  corresponding  to  each  output  and 
variable  input  included  in  the  model.  In  each  rov?  there  will  be  one 
coefficient  for  each  process  (column)  though  some  of  these  will  be  zero. 

Table  39  shov/s  the  structure  of  the  G Matrix  comprised  of  the  two  sets  of 
coefficients.  The  flov;  coefficient  (upper)  portion  will  be  called  the 
A Matrix,  the  constraint  coefficient  (lower)  portion  will  be  called  the 
B Matrix.  The  former  has  23  rows,  the  latter  17  rows.  Both  have  17 
columns  of  course.  Thus  G has  40  rows  and  17  columns  and  may  be  written 

G = ... 

The  T Matrix:  The  T Matrix  also  contains  two  coefficient  types: 


(1)  several  sets  of  prices  for  the  inputs  and  outputs  described  in  the 

G Matrix,  each  set  corresponding  to  a given  year,  and  (2)  coefficients 

for  carrying  rox7s  of  the  A or  B matrices  onto  the  new  H Matrix. 

The  prices  are  arranged  in  rcn^s,  x/ith  one  row  for  each  complete  set 

(or  year)  and  one  column  for  each  rox7  of  the  A Matrix,  The  row  names 

are  P1950,  P1958  and  the  column  names  are  the  same  as  the  row  names 

T 

of  the  A Matrix,  This  9 x 17  block  we  shall  call  the  P Matrix, 

The  arrangement  of  the  complete  T Matrix  is  as  follows; 


T = 


I 


-0 
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We  can  see  then  that  TG  = H yields 


z 

H = 

= 

T 

The  P A = Z operation  yields  a 9 x 17  matrix,  each  column  of  which 
corresponds  to  a process  and  each  row  of  which  corresponds  to  a year. 

Its  contents  give  the  net  return  for  each  process  in  each  year.  The 
is  simply  a matrix  with  one  column  for  each  row  of  the  A Matrix  and 
one  row  for  each  rov;  of  the  A Matrix  which  we  wish  to  carry  onto  the  H 
Matrix.  The  complete  T Matrix  is  shown  in  Table  40  and  the  H Matrix 
resulting  from  the  transformation  is  shoiim  in  subsection  d below  in 
Table  42.  The  listing  of  the  I-tape  containing  the  G and  H matrices  is 
shovm  in  Table  41,  Both  matrices  are  placed  on  the  same  I-tape  as 
files  one  and  two  respectively.  This  I-tape  also  contains  a third  matrix 
in  LP/90  format  as  a third  file.  The  latter  will  be  used  in  Example  6 
and  will  be  described  there. 
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The  Agenda  for  this  example  consists  of  the  following  eight 
Agendum  control  cards 

1 13  26  41 

HEADING  USDA  LP/90  EXAMPLE  5 L?  MATRIX  GENERATION 

INPUT , 23 , , COUNTS  ,MATRIXG , 7 5 

GET0FF,A8 

INPUT, 54 , , COUNTS , MATRIX! 

TRANSFORM  ,A8 
PICTURE 

A. TO. I, B9, REWIND 
OUTPUT, 


The  second  card,  INPUT, 23,  etc,,  causes  the  following  tasks  to  be 
performed,  (1)  Read  the  first  file  from  the  I- tape  containing  the 
G Matrix.  (2)  Convert  it  to  binary.  (3)  Place  it  on  the  A-tape.  The 
following  GET0FF,A8,  causes  the  G Matrix,  now  in  binary  and  initialized 
properly,  to  be  stored  on  tape  unit  A8.  The  succeeding  card,  INPUT, 54, 
etc,,  causes  the  second  file  of  the  I-tape  containing  the  T Matrix  to  be 
read,  and  to  be  converted  to  binary  and  stored  on  the  A-tape.  It  thus 
replaces  the  G Matrix  on  the  A-tape, 

TRANSFORM,. A8  now  takes  the  T Matrix  on  the  A-tape,  multiplies  it 
times  the  G Matrix  on  the  A8  tape,  and  produces  the  H Matrix  which  replaces 
the  T Matrix  on  the  A-tape.  After  TRANSFO^,  the  A-tape  and  the  computer's 
core  memory  are  in  precisely  the  condition  that  would  result  if  the  H Matrix 
had  been  read  in  from  the  I-tape  by  INPUT  rather  than  having  been  created 
by  TRANSFORM.  Thus,  at  this  point  a NORMAL  or  any  other  LP  or  LP- related 
Agendum  could  be  applied  using  the  H Matrix  as  input.  In  the  interest  of 
simplicity  we  have  not  done  this,  Inj^tead,  we  introduce  two  PROP  Agendum 
routines.  The  first  is  PICTURE,  and  the  second,  A.TO.l, 
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PICTURE  prepares  a schematic  or  stylized  representation  of  the 
H Matrix  (or  any  LP  matrix  created  by  INPUT  or  TRANSFORM  on  the  A- tape) 
which  is  quite  useful  for  model  debugging,  just  as  is  the  COUNTS  option  o 
INPUT. 

A.TO. I, B9,  REWIND  converts  the  binary  A-tape  to  BCD  or  I-tape 
format.  This  can  be  printed  and,  in  this  case,  gives  us  in  I-tape  format 
the  results  of  the  TRANSFORM  computation. 

The  MA^RIXG  and  MATRIXT  options  of  INPUT  and  TRANSFORM  are  USDA 
Agenda.  PICTURE  and  A.TO. I are  PROP  Agenda.  The  rest  belong  to  the 
SHARE  system. 

d . Output 

The  Output  consists  of  two  rarts:  (i)  the  result  of  PICTUPvE^ 

(2)  the  result  of  A.TO. I.  The  former  is  found  on  the  0-tape  after  OUTPUT 
The  latter  is  found  by  listing  off-line  the  tape  on  unit  B9  at  the 
com.pletion  of  the  run. 

The  results  of  PICTURE  come  first  on  the  0-tape  listing.  Then 
comes  the  output  in  the  order  of  the  Agendum  cards.  In  Table  43,  the 
results  of  PICTURE  are  shown.  Column  names  are  listed  on  the  top  of  the 
matrix  with  letters  printed  vertically,  (The  column  ICOTll  appears  as 

1 

C 

0 

T 

1 

1 

and  so  forth.) 

This  schematic  picture  of  the  matrix  reveals  whether  all  desired 
coefficients  got  computed,  or  carried  over  to  the  H Matrix.  It  also 
shows  the  numbers  in  decimal  magnitude  so  that  the  very  common  errors  of 
misplaced  decimal  points  are  quickly  revealed. 

Table  44  presents  a listing  of  the  I-tape  (on  B9)  produced  by 
A.TO. I.  It  is  simply  Table  42  in  I-tape  format. 
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Table  44:  New  I-Tape  Listing  H-Matrix  Output  From  A.  to  I.  Agendum — Continued 
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6„  RECURSIVE  LINEAR  PRCGR/M-IING 


a.  Purpose 

A recursive  linear  prograimiiing  model  (RL?)  consists  of  a sequence 
of  recursively  dependent  linear  programming  problems.  ’’Recursive  dependence 
means  that  for  a given  LP  problem  the  right -hand- side  elements  and/or  the 
objective  function  parameters,  and/or  the  active  constraint  matrix 
coefficients  depend,  in  a well  defined  way,  upon  the  solution  of  the 
preceding  LP  problem  or  problems.  The  purpose  of  this  sixth  and  final 
example  is  to  illustrate  ho\7  a special  class  of  RLP  models  may  be  solved 
automatically  by  USDA-LP/90, 

This  class  of  RLP  models  has  the  following  structure.  The  objective 
function  elements  are  ’’exogenous, ” that  is,  they  are  pre-deterrained  data, 
not  dependent  on  the  preceding  problem’s  solution.  The  matrix  elements  are 
constant  over  time.  Finally,  the  right-hand- side  elements  are  found  by 
multiplying  the  preceding  problem’s  solution  by  a change  matrix  and  adding 
to  the  resulting  vector  a dummy  right-hand- side  vector  of  exogenous 
right-hand- side  elements.  It  is  the  Type  I RLP  discussed  in  Part  II 
above . 

As  with  any  dynamic  system,  the  progress  of  the  RLP  model  from, 
one  period  to  the  next  depends  upon  initial  conditions.  T\vo  options  are 
available  for  introducing  initial  conditions  for  an  RLP  run.  This 
example  discusses  one  such  option,  the  introduction  of  an  initial  "solution" 
vector.  An  alternative,  the  introduction  of  an  initial  right-hand- side 
is  discussed  in  sub- section  e below. 

The  RLP  features  contain  two  options  for  the  "change  matrix" 
used  to  compute  the  right-hand- sides  of  succeeding  problems.  A general 
change  matrix  may  be  used  directly  (Type  II  RLP)  or,  if  the  change  matrix 
has  a very  special  form,  it  may  be  computed  automatically  (Type  I,  RLP). 

The  latter  option  is  illustrated  here. 

The  example  is  based  on  the  algebraic  discussion  of  Part  II, 

Section  6.  The  reader  may  wish  to  review  that  text  before  continuing 
with  the  discussion  of  this  example. 
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b.  Data 

The  input  data  for  this  problem  consist  of  (1)  the  LP  matris:  (H  Matrix) 
created  in  Example  5 (note  that  it  contains  nine  objective  function 
rov/sl);  (2)  a diagonal  matrix  (P  matrix)  of  change  coefficients  for  use 
in  creating  the  change  matrix;  (3)  an  initial  “solution'^  vector  for  the 
based  year,  after  which  production  decisions  are  to  be  forecast  or 
explained;  (4)  the  vectors  of  exogenously  determined  right-hand- side 
elements. 

The  first  item  is  shovm  in  Table  42  above  and  a description  of 
it  need  not  be  repeated  here.  We  merely  remind  ourselves  that  its  nine 
objective  function  rows  are  based  on  nine  successive  years’  prices. 

For  example,  the  P1950  row  gives  the  net  returns  for  each  process  using 
1950  prices,  and  so  on. 

The  second  item  (T  matrix)  shown  in  Table  45  belovj,  is  multiplied 
times  the  active  constraint  portion  of  the  UP  matrix  (the  "B”  matrix)  to 
create  the  change  matrix  (0  matrix) , The  first  six  rows  of  the  P matrix 
are  all  zero,  for  these  are  exogenously  given  rows.  That  is,  the  amounts 
of  both  soil  types,  of  labor  and  fertilizer,  and  the  magnitudes  of  the 
cotton  and  rice  allotments  are  exogenously  determined.  They  are  not 
related  to  the  preceding  year’s  solution.  The  next  rows  give  the  ’’upper 
flexibility  coefficients  (plus  one)”  for  the  total  acreage'  of  the  five 
crops,  while  the  next  five  rows  give  the  ’’lower  flexibility  coefficients” 
(subtracted  from  one).  Finally  the  last  row  gives  the  ’’investment 
coefficient"  (plus  one)  for  the  cotton  stage  II  processes. 

The  initial  conditions  are  also  shoxm  in  Table  45,  They  give 
the  estimated  actual  acreage  planted  for  the  base  year,  v/hich  is,  in 
this  case,  1950.  This  vector  will  enable  us  to  compute  the  right-hand- 
side  for  the  first  UP  problem  in  the  sequence. 

Finally,  the  exogenous  vectors  are  sho\m  in  Table  46,  The^e 
are  placed  on  the  change  matrix  as  dummy  right-hand- sides  (we  will  see 
how  this  is  done  belo^/)  and  are  added  to  the  vector  which  results  from 
multiplying  the  change  matrix  times  the  preceding  solution.  In  this 
way  the  exogenously  determined  RHS  elements  are  created  for  a given  year’s 

LP  problem.  The  negative  entries  in  the  LBCOT  and  LBRIG  rows  are  designed 

to  prevent  an  infeasibility  from  occurring  during  years  with  acreage  allot- 
ment s . 
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Table  45  i Diagonal  Elements  of  P-Matrix  And  Initial  Process  Levels 


Row  and  Column 
Symbol 

Element  Value 

Column  S}mibol 

Process  Level 

SOILl 

.00 

ICOTll 

0.00 

S0IL2 

.00 

1C0T12 

354.37 

LABF4 

.95 

1C0T21 

318.75 

FERT 

.75 

1C0T22 

0.00 

LOTCT 

,00 

2C0T11 

0.00 

LOTRC 

.00 

2C0T12 

26.88 

UBCOT 

1.10 

2COT21 

0.00 

UBOAT 

1.30 

2COT22 

0.00 

UBSGB 

1.30 

lOATll 

238.75 

UBALF 

1.15 

10AT12 

0.00 

UBRIC 

1,50 

10AT21 

101.25 

LBCOT 

.80 

1CAT22 

0.00 

LEOAT 

.74 

ISBGll 

650,00 

LESBG 

,74 

1SBG21 

0.00 

LBALF 

.76 

lALFll 

230.00 

LBRIC 

.90 

1RIC21 

80.00 

S2C0T 

1.25 

1RIC22 

0.00 

Table  46  : Exogenous  RHS -Vectors 


Row 

Column  Svmbo] 

Symbol 

C1951 

C1952 

C1953 

C1954 

G1955 

C1956 

C1957 

C1958 

C1959 

SOILl 

1500 

1500 

1500 

1500 

1500 

1500 

1500 

1500 

1500 

S0IL2 

500 

500 

500 

500 

500 

500 

500 

500 

500 

LABP4 

FERT 

2000 

2000 

2000 

2000 

2000 

2000 

2000 

2000 

2000 

LOTCT 

5000 

5000 

50000 

1000 

950 

925 

920 

900 

925 

LOTRC 

UBCOT 

UBOAT 

UBSBG 

UBALF 

UBRIC 

5000 

5000 

5000 

150 

125 

115 

110 

100 

130 

LBCOT 

LBOAT 

LBSBG 

LBALF 

-2000 

-2000 

-2000 

-2000 

-2000 

-2000 

LBRIC 

S2C0T 

-2000 

-2000 

-2000 

-2000 

-2000 

-2000 
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c . The  Agenda 

The  Agenda  is  shown  in  Table  47. 

The  first  Agendum  card  is  our  familiar  INPUT.  It  reads  the  BCD 
tape  created  by  AoTOoI  in  Example  5.  We  could  have  used  the  binary 
A- tape  created  by  TRANSFORM  in  Example  5 instead  and  in  that  way  avoided 
using  INPUT. 

The  second  Agendum  card  is  a new  one  designed  especially  for  RLP 
runs  with  USDA  LP/90.  Its  function  is  to  read  the  changej(^)  matrix  and 
the  exogenous  vectors.  The  change  matrix  is  in  LP  format  and  must  have 
exactly  the  same  row  ID  as  the  basic  LP  matrix.  In  this  case,  the  change 
matrix  is  a "dummy"  one  and  the  Agendum  is  used  only  to  read  the  exogenous 
vectors.  This  is  because  the  change  matrix  for  this  example  is  to  be 
computed  from  the  P-matrix  and  the  B matrix  portion  of  the  LP  matrix. 

The  third  Agendum,  GAMMAB,  CR,  (1)  reads  from  the  card  reader  (as 
designated  by  the  CR)  the  P-matrix  coefficients,  (2)  multiplies  them  times 
the  "B"  portion  of  the  LP  matrix  and  (3)  stores  the  resulting  change 
matrix  ($)■  on  the  change  matrix  tape  in  place  of  the  dummy  one  read  in. 

The  Agendum  GAMMAB ,CR , INITIATE  reads  from  the  card  reader  the 
initial  solution  vector  (initial  process  levels).  The  next  Agendum, 

CREATE, 51, 51,  INITIATE  (1)  multiplies  the  change  matrix  (<I>)  times  the 
initial  solution  vector  just  read  in  by  the  preceding  Agendum,  (2)  adds 
the  exogenous  vector  numbered  51  and,  (3)  stores  the  result  as  RHS  number 
51  on  the  A-tape  or  binary  LP-matrix.  The  next  Agendum  routines  are 
already  familiar  to  us.  In  groups  of  three,  they  provide  for  (1)  solving 
the  LP  problem  based  on  the  objective  function  for  the  preceding  year, 
the  RHS  just  created  from  the  solution  of  the  preceding  year,  and  the 
exogenous  RHS  elements  for  the  current  year;  (2)  writing  a report  of  the 
solution;  (3)  creating  the  new  RHS  for  the  succeeding  problem.  Finally, 
at  the  very  end  comes  OUTPUT  with  which  we  are  already  familiar. 

The  REPORT  Agendum  uses  the  same  report  writing  program  compiled 
in  Example  3.  As  our  process  names  are  precisely  the  same  as  in  that 
example,  and  as  the  yield  coefficients  are  unchanged,  this  usage  is  possible. 


Table  47:  AGENDA  FOR  RLP  EXAMPLE 
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d.  Output 

The  listing  of  the  0-tape  for  this  run  contains  first  the  tables 
prepared  by  the  REPORT  Agendum.  These  are  shown  in  Table  48.  After  the 
reports  comes  the  run  history  including  the  Agendum  cards,  the  timing 
comments,  and  the  full  solution  print-outs.  As  the  reader  is  already 
familiar  with  the  run  history  listing  for  preceding  examples,  this  is 
omitted  here. 

However,  to  show  the  nature  of  the  solution  of  an  RLP  model,  several 
graphs  are  presented  in  Figures  15  through  17.  These  show  respectively, 
the  acreages  of  the  five  crops,  the  dual  variables  of  the  five  crops  and 
the  program  value  for  each  year.  The  first  two  were  taken  from  the 
tables  computed  by  PvEPORT  while  the  latter  were  taken  directly  from  the 
full  solution  print-outs  (not  shown). 
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Table  48:  OUTPUT  FROM  REPORT  AGENDUM 


(Listing  Sheet  1) 


USDA  LP/90 

EXAMPLE  6 RLP  FOR  1951 

OUTPUT 

SUMMARY 

CROP  / 

PRODUCTION 

ACREAGE 

AVE  YIELD 

COTTON  LINT 

3,410,896 

560,000 

6,09 

COTTON  SEED 

5,811,543 

560,000 

10,38 

OATS 

14,708,020 

251,600 

58.46 

SOYBEANS 

24,505,000 

845,000 

• 

O 

o 

ALFALFA 

462,438 

223,400 

2.07 

RICE 

4,272,000 

120,000 

35.60 

FIELD 

CROP  ACREAGE 

BY  SOIL  TYPE 

CROP  / 

SOIL  1 

SOIL  2 

TOTAL 

COTTON 

416,274 

143,726 

560,000 

OATS 

15,326 

236,274 

251.600 

SOYBEANS 

845,000 

845,000 

ALFALFA 

223,400 

223,400 

RICE 

120,000 

120,000 

FIELD  CROP  ACREAGE 

BY  FERTILIZER  LEVEL 

CROP  / 

LEVEL  1 

LEVEL  2 

TOTAL 

COTTON 

143,726 

416,274 

560,000 

OATS 

1,936 

249,664 

251,600 

RICE 


120,000 


120,000 
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Table  48:  OUTPUT  FROM  REPORT  AGENDUM- -Continued 


(Listing  Sheet 

2) 

USDA  LP/90 

EXAMPLE  6 RLP  FOR 

1952 

OUTPUT 

SUMMARY 

CROP 

/ 

PRODUCTION 

ACREAGE 

AVE  YIELD 

COTTON  LINT 

3,278,806 

457,683 

7.16 

COTTON  SEED 

5,586,992 

457,683 

12.21 

OATS 

18,688,000 

320,000 

58.40 

SOYBEANS 

25,303,455 

872,533 

29.00 

ALFALFA 

351,453 

169,784 

2.07 

RICE 

6,408,000 

180,000 

35.60 

FIELD 

CROP  ACREAGE 

BY 

SOIL  TYPE 

CROP 

/ 

SOIL  1 

SOIL  2 

TOTAL 

COTTON 

457,683 

457.683 

OATS 

320.000 

320.000 

SOYBEANS 

872,533 

872.533 

ALFALFA 

169,784 

169,784 

RICE 

o 

o 

o 

•> 

o 

GO 

180.000 

FIELD  CROP  ACREAGE 

BY  FERTILIZER  LEVEL 

CROP 

/ 

LEVEL  1 

LEVEL  2 

TOTAL 

COTTON 

457,683 

457,683 

OATS 

320,000 

320.000 

RICE 


180,000 


180,000 
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Table  48:  OUTPUT  FROM  REPORT  AGENDUM- -Continued 


(Listing  Sheet  3) 


USOA  LP/90 

EXAMPLE  6 RLP  FOR  1953 

OUTPUT 

SUMMARY 

CROP  / 

PRODUCTION 

ACREAGE 

AVE  YIELD 

COTTON  LINT 

3,153,714 

441,427 

7.14 

COTTON  SEED 

5,373,800 

441,427 

12.17 

OATS 

13,874,680 

236,600 

58.59 

SOYBEANS 

26,759,380 

922,737 

29.00 

ALFALFA 

267,104 

129,036 

2.07 

RICE 

9,612,000 

270,000 

35.60 

FIELD 

CROP  ACREAGE 

BY  SOIL  TYPE 

^ CROP  / 

SOIL  1 

SOIL  2 

TOTAL 

COTTON 

441,427 

441,427 

OATS 

6,800 

230,000 

236,800 

SOYBEANS 

922,737 

922,737 

ALFALFA 

129,036 

129,036 

RICE 

270,000 

270,000 

FIELD  CROP  ACREAGE 

BY  FERTILIZER  LEVEL 

CROP  / 

LEVEL  1 

LEVEL  2 

TOTAL 

COTTON 

441,427 

441,427 

OATS 

236,800 

236,800 

RICE 


270,000 


270,000 
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Table  48:  OUTPUT  FROM  REPORT  AGENDUM- -Continued 


(Listing  Sheet  A) 


USDA  LP/90 

EXAMPLE  6 RLP  FOR  1954 

OUTPUT 

SUMMARY 

CROP  / 

PRODUCTION 

ACREAGE 

AVE  YIELD 

COTTON  LINT 

3,023,665 

424,747 

7,12 

COTTON  SEED 

5,152,155 

424,747 

12.13 

OATS 

17,977,856 

307,840 

o 

• 

00 

SOYBEANS 

29,055,116 

1,019,346 

28.50 

ALFALFA 

202,999 

98,067 

2.07 

RICE 

5,340,000 

150,000 

35.60 

FIELD 

CROP  ACREAGE 

BY  SOIL  TYPE 

CROP  / 

SOIL  1 

SOIL  2 

TOTAL 

COTTON 

424,747 

424.747 

OATS 

307,840 

307,840 

SOYBEANS 

977,186 

42,160 

1,019,346 

ALFALFA 

98,067 

98,067 

RICE 

150,000 

150,000 

FIELD  CROP  ACREAGE 

BY  FERTILIZER  LEVEL 

CROP  / 

LEVEL  1 

LEVEL  2 

TOTAL 

COTTON 

424,747 

424, 747 

OATS 

307,840 

307,840 

RICE 

150,000 

150, GOO 
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Table  48:  OUTPUT  FROM  REPORT  AGENDUM --Continued 


(Listing  Sheet  5) 


USDA  LP/90 

EXAMPLE  6 RLP  FOR  1955 

OUTPUT 

SUMMARY 

CROP 

/ 

PRODUCTION 

ACREAGE 

AVE  YIELD 

COTTON  LINT 

2,986,524 

421,243 

7.09 

COTTON  SEED 

5,088,814 

421,243 

12.08 

OATS 

21,900,000 

375,000 

58.40 

SOYBEANS 

29,122,539 

1,004,226 

29.00 

ALFALFA 

154,279 

74,531 

2.07 

RICE 

4,450,000 

125,000 

35.60 

FIELD 

CROP  ACREAGE 

BY  SOIL  TYPE 

CROP 

/ 

SOIL  1 

SOIL  2 

TOTAL 

COTTON 

421,243 

421,243 

OATS 

375,000 

375,000 

SOYBEANS 

1,004,226 

1,004,226 

ALFALFA 

74,531 

74,531 

RICE 

125,000 

125,000 

FIELD  CROP  ACREAGE 

BY  FERTILIZER  LEVEL 

CROP 

/ 

LEVEL  1 

LEVEL  2 

TOTAL 

COTTON 

421,243 

421,243 

OATS 

375,000  . 

375,000 

RICE 

125,000 

125,000 
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Table  48:  OUTPUT  FROM  REPORT  AGENDUM --Continued 


(Listing  Sheet  6) 


USDA  LP/90 

EXAMPLE  6 RLP  FOR  1956 

OUTPUT 

SUMMARY 

CROP  / 

PRODUCTION 

ACREAGE 

AVE  YIELD 

COTTON  LINT 

2,961,794 

419,865 

7.05 

COTTON  SEED 

5,046,610 

419,865 

12.02 

OATS 

22,484,000 

385,000 

OD 

• 

o 

SOYBEANS 

29,681,238 

lt023,491 

29.00 

ALFALFA 

117,252 

56,644 

2.07 

RICE 

4,094,000 

115,000 

35.60 

FIELD 

CROP  ACREAGE 

BY  SOIL  TYPE 

CROP  / 

SOIL  1 

SOIL  2 

TOTAL 

COTTON 

419,865 

419.865 

OATS 

385.000 

385.000 

SOYBEANS 

1,023,491 

1.023.491 , 

ALFALFA 

56,644 

56,644 

RICE 

115,000 

115,000 

FIELD  CROP  ACREAGE 

BY  FERTILIZER  LEVEL 

CROP  / 

LEVEL  1 

LEVEL  2 

TOTAL 

COTTON 

419,865 

419,865 

OATS 

385,000 

385,000 

RICE 

115,000 

115,000 
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Table  48;  OUTPUT  FROM  REPORT  AGENDUM- -Continued 


(Listing 

Sheet  7) 

USDA  LP/90 

EXAMPLE  6 

RLP  FOR  1957 

OUTPUT 

SUMMARY 

CROP  / 

PRODUCTION 

ACREAGE 

AVE  YIELD 

COTTON  LINT 

2,983,094 

425,364 

7.01 

COTTON  SEED 

5,082,826 

425,364 

11.95 

OATS 

22,776,000 

390,000 

58.40 

SOYBEANS 

29,916,003 

1,031,586 

29.00 

ALFALFA 

89,112 

43,049 

2.07 

RICE 

3,916,000 

110,000 

35.60 

FIELD 

CROP  ACREAGE  BY  SOIL  TYPE 

CROP  / 

SOIL  1 

SOIL  2 

TOTAL 

COTTON 

425,364 

425.364 

OATS 

390,000 

390,000 

SOYBEANS 

1,031,586 

1,031,586 

ALFALFA 

43,049 

'-3,049 

RICE 

110,000 

110,000 

FIELD  CROP  ACREAGE 

BY  FERTILIZER  LEVEL 

CROP  / 

LEVEL  1 

LEVEL  2 

TOTAL 

COTTON 

425,364 

425,364 

OATS 

390,000 

390,000 

RICE 

110,000 

110,000 
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Table  48;  OUTPUT  FROM  REPORT  AGENDUM- -Continued 


(Listing  Sheet 

8) 

USDA  LP/90 

EXAMPLE  6 RLP  FOR  1958 

OUTPUT 

SUMMARY 

CROP  / 

PRODUCTION 

ACREAGE 

AVE  YIELD 

COTTON  LINT 

3,058,932 

439,045 

6.97 

COTTON  SEED 

5,211,955 

439,045 

11.87 

OATS 

23,360,000 

400,000 

CD 

• 

o 

SOYBEANS 

29,818,890 

1,028,238 

29.00 

ALFALFA 

67,725 

32.717 

2.07 

RICE 

3,560,000 

100,000 

35.60 

FIELD 

CROP  ACREAGE 

BY  SOIL  TYPE 

CROP  / 

SOIL  1 

SOIL  2 

TOTAL 

COTTON 

439,045 

439,045 

OATS 

400,000 

400,000 

SOYBEANS 

1,028,238 

1,028,238 

ALFALFA 

32,717 

32,717 

RICE 

100,000 

100,000 

FIELD  CROP  ACREAGE  BY  FERTILIZER  LEVEL 

CROP  / 

LEVEL  1 

LEVEL  2 

TOTAL 

COTTON 

439,045 

439,045 

OATS 

400,000 

400,000 

RICE 

100,000 

100,000 
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Table  48:  OUTPUT  FROM  REPORT  AGENDUM- -Continued 


(Listing  Sheet  9) 


USDA 

LP/90 

EXAMPLE  6 RLP  FOR  1959 

OUTPUT 

SUMMARY 

CROP 

/ 

PRODUCTION 

ACREAGE 

AVE  YIELD 

COTTON  LINT 

3,200,187 

462,571 

6.92 

COTTON  SEED 

5,452,530 

462,571 

11.79 

OATS 

21,608,000 

370,000 

58.40 

SOYBEANS 

29,364,338 

1,012,563 

29.00 

ALFALFA 

51,471 

24,865 

2.07 

RICE 

4,628,000 

130,000 

35.60 

FIELD 

CROP  ACREAGE 

BY  SOIL  TYPE 

CROP 

/ 

SOIL  1 

SOIL  2 

TOTAL 

COTTON 

462,571 

462,571 

OATS 

370.000 

370.000 

SOYBEANS 

1,012,563 

1.012.563 

ALFALFA 

24,865 

24,865 

RICE 

130.000 

130,000 

FIELD  CROP  ACREAGE 

BY  FERTILIZER  LEVEL 

CROP 

/ 

LEVEL  1 

LEVEL  2 

TOTAL 

COTTON 

462,571 

462,571 

OATS 

370,000 

370,000 

RICE 

130,000 

130,000 

HEADING 

USDA 

LP/90 

EXAMPLE  6 

RECURSIVE  LINEAR 

PROGRAMMING 

500,000 
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FIGURE  15:  PROCESS  LEVELS  TOTALLED  BY  CROP 
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FIGURE  16:  MARGINAL  VALUES  OF  THE  CONSTRAINTS 


200 
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FIGURE  17;  TOTAL  NET  RETURl'IS 
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e . Remarks 

The  entire  run,  including  all  of  the  input  preparation  Agendum 
routines,  the  REPORTS  and  OUTPUT  took  ,0832  hours:  a shade  under  five 

minutes!  As  in  the  preceding  examples,  this  is  a remarkable  performance 
even  on  the  simple  problem  used  for  illustration,  and,  as  before,  almost 
the  entire  time  was  consumed  reading  the  Agendum  cards,  reading  the 
specified  Agendum  routines  into  the  core  from  the  Operation  Tape, 
printing  the  on-line  messages  and  writing  the  O-tape  data. 

The  RLP  model  reported  in  [2  ] contained  one  hundred  processes 
and  37  active  constraints.  It  led  to  seventeen  LP  problems  corresponding 
to  seventeen  years  from  1941-1958.  These  were  executed  in  about  12 
minutes!  Hhile  even  that  model  is  small  as  LP  problems  go,  the  performance 
is  remarkable — at  least  by  present  day  standards,  (^nfho  knows  how  slow 
this  will  appear  in  several  years'  time?) 

In  fact  it  can  be  said  that  TRANSFORM  and  the  Agendum 
routines  illustrated  in  this  example  make  RLP  a workable  new  tool  for 
econometric  analysis.  Without  them  a few  minutes  calculations  would  be 
compounded  into  weeks  of  combined  desk  calculating  and  computer  running. 
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PART  V:  USER*S  REFERENCE  GUIDE  TO  THE 

AGENDUM  ROUTINES 


Detailed  Content s 


INTRODUCTION 
1 . SHARE  AGENDA 

Agendum  Name  Brief  Description 

(Start  in  Column  1) 


Detailed 
De  script  ioti 
Found  on 


^ASSIGN 

CONTROLS 


For  operators  only.  Can  be  used  once  at 
the  beginning  of  a run. 

Set  values  of  control  parameters  224 


COST. RANGING  Obtain  the  range  over  which  the  objective 

function  coefficients  of  basic  variables 
can  be  varied,  one  element  at  a time, 
without  requiring  a change  of  basis « 

COST. RANGING, NAjMES  Same  as  COST. RANGING  except  that  only  the 

vectors  with  names  given  on  succeeding 
cards  are  considered. 

COST. RANGING, CLASS, W,F  Same  as  COST^RANGING  except  that  a set  of 

contiguous  columns  of  length  W is  set  up 
starting  in  column  F+1  of  the  coltamn  name. 
The  following  cards  define  the  class 
characters . 


226 


227 


227 


DO.D/J,RgN,gN  Compute  and  print  d.s  "relative  cost" 

or  "profit"  vectors^  Current  row  or  sum 
of  rows  if  R is  not  used. 

R s:  Row  Number 

g = C for  curtain,  = P for  partition 
N =:  curtain  or  partition  number. 


DO. PLP,C,T,D,K, SPEC, COMP 

Parametric  programming  on  right  hand  side 
after  optimal  solution  is  reached. 

C = Change  Vector  Number 

T «=  Max.  Theta 

D s=  Delta  Theta  for  Printing 

K = New  Rt.  Hand  Side  Number 

SPEC  = K0  specified  theta  even  if  unbounded 

COMP  = K(P  theta  unbounded 
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Agendum  Name 
DO.PCR,Q,P,D 


FIX.VEC,B,K 


GETOFF 


GETOFF.cu 


GETOFF, PRINT 


Brief  Description 

Parametric  programming  on  cost  row  after 
optimal  solution  is  reached. 

Q = Change  cost  row  number  (or  name  if  * 
in  col  8) 

P = Max.  Phi 

D = Delta  Phi  for  Printing 

The  vectors  on  the  following  cards  are 
multiplied  by  the  given  scalar  quantity 
and  subtracted  from  RHS  B;  the  resulting 
vector  is  output  as  RHS  K. 

Writes  restart  information  on  Mediary 
(Binary)  Output  Tape  and  B Tape  if  desired 

Writes  restart  information  on  channel  c 
tape  unit  u.  Follow  by  OUTPUT  or  RESTART,  cu 

Print  output  after  doing  a GETOFF 


Detailed 
Description 
Found  on 

232 


233 


234 

234 

234 


HEADING  OR  HEADING, SAVE 

Starts  new  problem.  Identification  punched 
in  columns  13-72  will  print  on  each  output 
page. 


INPUT , q , n , COUNTS , REWIND , PUNCH 

Used  for  initial  matrix  assembly  when  sorted 
by  columns.  Sets  R=  q-1,  B = 1 for  NORMAL, 
q = integer  number  of  functional  rows.  Since 
numbering  starts  at  zero  it  is  also  the 
internal  numerical  index  of  the  first 
restraint  row. 

n s=  number  of  problems  to  skip. 

LIST  = COUNTS 


235 


INTRODUCE, R,B 


Used  to  enter  vectors  into  basis 
data  cards  follow. 

R = Row  Number  (functional) 

B = Right  hand  side 


Special 


238 


INVERT 

INVERT, NO. PUNCH 


Start  reinversion  of  current  basis 

Same  as  INVERT  except  that  punchouts  are 
not  obtained. 


239 

239 


INVERT, NOT. INCORE 


Same  as  INVERT  except  that  problem  will 
be  set  for  tape  operation  after  inversion. 


239 


LDBINARY  Loads  absolute  binary  restart  cards  produced  240 

by  PUNCH.  Binary  cards  must  be  followed  by 
blank  card.  The  last  six  cards  for  the 
communications  region  should  usually  be 
removed  when  LDBINARY  immediately  follox'i7s 
INPUT.  Cols.  13-72  for  problem  identification 
when  not  blank. 


Afiendum  Name 


Brief  Description 


Detailed 
Description 
Found  on 


LDHREG  Same  as  LDBINARY  except  that  it  loads 

punch-outs  sjTubo  lie  ally  into  H-Region; 
use  only  after  INPUT  or  REVISE;  remove 
Communications  Regions  cards.  LDHREG  must 
be  followed  by  INVERT. 

LP4290, V,X,REWIND, ALL  Converts  704  SCROL  input  on  A6  to  LP/90 

input  on  I- tape. 

V:  SCROL  Format,  0 = fixed,  1 = variable 

X:  Row  ID  Source.  0 = SCROL  HP's,  1 = 

card  reader 

*MDUMP , CODES ,REGNS , BUFFS 

Dumps  the  designated  portions  of  memory; 
the  communication  region  is  always  included 

NEW. BASIS  OR  NEW. BASIS , MOD 

Loads  basis  heading  cards  through  the  card 
reader  to  overlay  the  basis  in  the  machine. 

Start  main  composite  algorithm.  Algorithm 
uses  previous  cost  row  if  R is  not  given  and 
previous  right  hand  side  if  B is  not  given. 

R = Row  Number  (or  Name  if  * in  col.  8)  of 
functional 

B = Right  Hand  Side  Number 

End-of-Files  the  mediary  tape,  converts  the 
binary  output  for  printing  off-line  and 
terminates  run. 

Same  as  OUTPUT  but  does  not  end-of-file  so 
that  a rewound  mediary  tape  can  be  processed 

For  coders  only,  see  CEIR,  Inc.  Reference 
Manual 

Punches  binary  cards  for  restarting.  The  last 
six  cards  are  the  communications  region. 

Resets  theta,  phi,  change  vector  and  change 
cost  row  numbers  to  zero.  Required  after 
DO.PLP  or  DO.PCR  unless  continuing  with  the 
same  algorithm  on  the  same  computation. 

Restarts  from  GETOFF  (on  Mediary  Tape) , also 
functions  as  ASSIGN. 

Restarts'  from  GETOFF,  cu  where  c is  channel 
and  u is  tape  unit.  Must  be  preceded  by 
CONTROLS  if  starting  a new  mediary  tape. 


NORMAL, R,B 

OUTPUT 

OUTPUT, OLD 
*PATCH 
PUNCH 
RESET 

RESTART 
RESTART, cu 


241 

242 

242 

243 

244 

244 

244 

245 
245 

245 

245 
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Detailed 

Description 

Asendum  Namp  Brief  Description  Found  on 

REVISE  Rows,  columns,  and/or  revised  elements  246 

can  be  inserted  or  substituted  in  the 
binary  matrix  A-tape.  All  new  slack  will 
appear  at  the  end.  Col.  ID,  Curtains, 
partitions  and  slack  cards  may  not  be  used. 

CNT  and  SUM  cards  are  ignored. 

REVISE, q,n, PUNCH, REWIND, LIST 

Like  INPUT,  puts  the  binary  matrix  on  the  A-  246 
tape.  The  differences  from  input  are: 

Limited  number  (5,000)  of  elements  to  A-tape, 
element  order  is  immaterial.  Col  ID's  can 
be  used  like  Row  ID's  to  select  and  order 
columns,  curtains  and  partitions.  Slack  cards 
cannot  be  used,  CNT  and  SUM  cards  are  ignored. 

RHS. RANG INC  Obtain  the  range  over  which  the  right  hand  251 

side  elements  can  be  varied,  one  at  a time, 
without  requiring  a change  of  basis. 

RHS. RANGING, CLASS, W,F  Same  as  RHS. RANGING  except  that  a set  of  con-  251 

tiguous  columns  of  length  W is  set  up  starting 
in  column  F+1  of  the  column  name.  The  follow- 
ing cards  define  the  class  characters. 


SCALE, S Introduces  Scale  Factor,  S,  which  must  have  253 

decimal  point  and  may  be  negative.  (Precede 
number  by  minus  punch.)  Saves  old  scale  factor. 

STATUS  Prints  on  and  off-line  the  current  status  of  253 

all  tolerances  and  control  parameters. 

TABLEAU  Expresses  entire  matrix  in  terms  of  current  254 

basis. 

TABLE AU,FROMYAAAAA  S^e  as  TABLEAU  except  it  starts  processing  254 

at  the  vector  given. 

TABLEAU , INVERSE  Gives  the  complete  explicit  inverse  of  the  254 

current  basis.  (Except  for  artificial 
columns)  a 

TABLEAU , NAMES  Expresses  those  columns  given  on  following  254 

cards  in  terms  of  the  current  basis. 

UNSCRAMBLE  Sorts  the  primal  solution  to  the  vector  255 

order  of  the  input  tape. 
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. PROPRIETARY  AGENDA 


Agendum  Name 


Brief  Description 


Detailed 

Description 
Found  on 


ADDRHSjCu  Adds  the  RHS  described  in  the  cards  256 

following  (NEXT  B,N...E0F)  to  the  A-tape. 

A .TO . I , cu , REWIND , PACK , ROWS , RHS , Ni , . o .Nm . 

Produces  an  LP/90  format  input  tape  256 

tape  from  an  LP/90  A-tape  and  current 
H- region  in  core. 

CARD /TAPE, cu, LOW  Reads  the  following  cards  (until  END***)  257 

from  the  card  reader  and  puts  the  card 
images  on  tape  u Channel  c with  the 
density  given  (bbb  = HIGH) 

COMPILE , cu , cu ,N , REWIND 

Compiles  a report  witing  program  from  257 

Compile  Data  Cards  on  unit  designated 
by  first  cu  and  outputs  to  unit  designated 
by  second  cu  with  label  N. 


CORRECT , BCD , cu , cu , cu , n , J , Y , REWIND  ,L0W,  GENERAL 

Corrects  a BCD  tape  by  inserting,  deleting, 
or  changing  any  number  of  records . 

DIFFERENCE, B1,B2,K  Computes  a new  right-hand -side,  K,  as  B1-B2 

and  places  it  on  A.-tape. 


EPSILON, 9 E The  zero  elements  of  RHS  B are  modified  by 

placing  E in  all  = and  < type  rows  and  -E 
in  all  > rows.  The  modified  RHS  is  output 
to  the  A-tape  as  K- , and  B-K.  is  output  as 

EXTSOLjEXTSOLjK  Multiplies  each  column  of  the  A-matrix  by 

BETA  and  outputs  the  individual  extensions 
in  TABLEAU  format . The  flag  means  that 
only  those  vectors  on  the  following  cards 
will  be  included. 


260 

2d2 

263 


263 


FLAGS, mode, specs  mode  = IGNORE:  Marks  specified  vectors  to  263 

prohibit  them  from  entering  the  solution 
and/or  to  remove  them  from  the  present  basis, 
mode  = RESTORE:  Remove  the  suppression  flag 

from  vectors  on  A-tape, 

PICTURE, HELP  Outputs  the  A-tape  matrix  and  RHS*s  in  265 

stylized,  condensed  format  for  off-line 
printing.  The  parameter  HELP  causes  only 
those  vectors  having  entries  in  infeasible 
rows  to  be  inc luded , 
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Agendum  Name 
REPORT, cu,N 

SENSIT,  SENSIT,K 
STACK, REPORT , cu , cu 
TITLE 

3.  USDA  AGENDA 

Agendum  Name 
CREATE,C,K 

CREATE , C , K , INITIATE 
GAMMAB,cu 

GAMMAB , cu , INIT lATE 

INPUT, . . . ,MATRIXG 

INPUT, . . . ,MATRIXT 


Brief  Description 

Outputs  LP  answers  in  a formal,  card 
controlled,  report  format  using  report 
writing  program  N.  Reference  may  be 
made  to  any  beta,  pi,  RHS,  objective 
value,  dj  or  Aij.  (See  COMPILE) 

Gives  the  rate  of  change  in  the  objective 
function  for  a small  change  in  the  non- zero 
coefficients  of  the  optimal  basis. 

Stacks  compiled  report  writing  programs 
on  a single  tape  for  later  use  by  the 
REPORT  agendum. 

The  information  in  columns  13-72  of  the 
agendum  card  replaces  the  page  heading 
on  all  subsequent  printout. 


Brief  Description 

Generates  a new  right-hand- side  of 
multiplying  the  "change  matrix"  times 
the  current  primal  solution  in  core  and 
adding  the  dummy  RHS  (Exogenous  vector) 
numbered  K.  New  RHS  is  given  number  C 
on  the  A-Tape. 

Same  as  CREATE, C,K  except  used  after 
GAMMAB , cu , INITIATE . 

Creates  a "change  matrix"  for  recursive 
Linear  Programming  by  premultiplying  the 
constraint  matrix  by  a diagonal  matrix 

Reads  from  specified  unit  initial  primal 
solution  variables  for  beginning  a 
Recursive  Linear  Programming  Run. 

Modification  of  SHARE  INPUT  Agendum 
for  inputting  basic  data  matrix  to  be 
used  by  TRANSFORM. 

Modification  of  SHARE  INPUT  Agendum 
for  inputting  transformation  matrix 
for  use  by  TRANSFORM. 


Detailed 
Description 
Found  on 


266 


267 


267 


267 


Detailed 
Description 
Found  on 


268 

268 

268 

269 

269 


269 
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Agendum  Name 


READ , CHANGE , l^IATRIX , Q 


TRAl^ISFORMjCU 


Detailed 

Description 

Brief  Description  Found  on 

N, COUNTS 

Reads  a "change  matrix"  and  exogenous  vector  270 
in  LP/90  I-Tape  format  for  Recursive  Linear 
Programming  run, 

Prelmultiplies  a matrix  (G)  by  a second  270 

matrix  (T) , both  in  I-Tape  format  to  give 
a third  matrix  (H)  in  LP/90  in  any  format 
on  the  A-Tape. 


223 


INTRODUCTION 

In  the  following  pages  all  of  the  Agendum  Routines  are  briefly 

described.  To  avoid  confusion,  each  Agendum  Routine  is  given  the  name 

27/ 

used  on  the  Agendum  Control  Card  that  calls  it. — Also,  to  facilitate 
the  use  of  this  section  as  a reference  guide,  each  such  routine  is 
listed  alphabetically  within  three  categories.  The  latter  correspond 
to  classification  of  the  routines  as  being  SHARE,  Proprietary  (PROP) 
or  USDA  routines.  The  reader  is  reminded  of  the  text  in  Part  I which 
explains  these  distinctions  and  describes  the  various  versions  of  LP/90 
on  which  they  appear.  Briefly,  USDA  LP/90  contains  all  of  these 
features;  the  SHARE  version  contains  only  the  SHARE  routines;  a public 
version  (PUBLIC  LP/90)  could  be  provided  that  would  contain  the  SHARE 
and  USDA  features  while  a proprietary  version  (PROP  LP/90)  is  available 
that,  like  the  USDA  version,  contains  all  three.  The  advantage  of 
PROP  LP/90  is  that 'new  Agendum  Routines  are  added  to  it  when  they  are 
written,  while  USDA  LP/90  contains  only  those  features  available  circa 
Spring  1963. 

It  is  quite  likely  that  the  material  presented  here  will  not 
be  sufficient  in  all  cases  to  enable  a prospective  user  to  go  ahead  on 
his  own--even  if  he  has  studied  the  examples  of  Part  IV.  The  selected 
references,  with  which  the  study  concludes,  contain  further  material  on 
LP/90  which  may  fill  in  the  necessary  gaps. 

The  material  in  sections  1 and  2 (SHARE  and  PROP  Agenda)  is 
a highly  edited  version  of  descriptions  previously  published  by 
CEIR,  Inc.  (see  references).  Section  3 (USDA  Agenda)  is  based  on  the 
original  programming  specifications  prepared  by  the  author  in  collaboration 
with  Eli  He  Herman  and  Hugh  Powell. 

An  asterisk  preceding  an  agendum  name  indicates  a routine  for  pro- 
grammers, operators,  or  other  advanced  users. 
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— The  Agendum  Control  Card  is  punched  with  the  Agendum  name 
beginning  in  card  column  one. 
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CONTROLS 


1 . SHARE  AGENDA 


Certain  parameters  which  control  the  function  of  NORMAL  and  the 
solution  printouts  are  set  by  HEADING.  CONTROLS  enables  the  user  to 
reset  these  paramters  later  in  a run.  Only  those  parameters  being 
reset  are  changed.  The  parameters  to  be  reset  are  entered  on  the 
Agendum  Control  Card  according  to  the  following  rules. 

All  values  must  be  left  lustified  or  have  leading  zeros. 

All  parameters  are  decimal  integers. 

The  tolerance,  E , is  a decimal  fraction  or  fixed  point  number.  It 
max 

must  have  a decimal  point  and  not  more  than  8 digits  following.  Any 
punching  other  than  blank,  a digit  or  a decimal  point  will  cause  this 
field  to  be  ignored. 

Blank  or  zero  for  a parameter  or  tolerance  will  give  the  initial 
value  shown  in  following  table. 


P^\RAMETERS 

Card 

Columns 

Symbol 

Initial 

Value 

Normal 

Value 

Frequencies 

On-line  log  (iteration  prints) 

11-15 

F 

* 

10 

and  clock  test  frequency. 
Off-line  log  (iteration  prints) 

16-20 

cp 

ct 

* 

1 

Off-line  full  solution  print 

21-25 

F 

s 

* 

d 

Punchout  of  K-H  regions 

26-30 

F 

p 

* 

ie 

No,  of  iterations  before  stop 

31-35 

T 

max 

* 

k 

No,  of  etas  before  first  rein- 
version 

36-40 

T. 

X 

•k 

E 

Index  Number—'^ 

Starting  Curtain 

41-45 

T 

*cs 

0 

Ending  Curtain 

46-50 

I 

ce 

* 

Starting  Partition 

51-55 

I 

ps 

0 

Ending  Partition 

56-60 

I 

pe 

ic 

— 4’or  an  explanation  of 

"curtains” 

and  "partitions"  see 

write  up 

of  INPUT  below. 
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Tolerance  for  Solution  Check  Cols.  Syiubol  Initial  Value 

Maximum  Allowable  Error  61-70  E ** 

max 

* Maximum  = 32767 
**  = 1.5  X 10‘® 

E = estimated  number,  often  1/2  m to  m. 


Frequencies  not  equal  to  32767  for  and  F^  will  suppress 
printing  and/ or  punching  during  an  automatic  invert  is  controlled  by  the 
clock  after  the  first  inversion  has  occurred. 

Partition  indices  set  by  a CONTROLS  card  are  effective  only  in 
NORMAL,  DO.PLP,  DO.PCPv,  and  TABLEAU.  The  starting  and  ending  partitions 
define  the  set  of  vectors  which  may  enter  the  basis.  The  partition 
codes  have  no  ability  to  insure  the  removal  of  vectors  not  V7ithin  the 
active  set.  Thus  it  is  possible  to  solve  a sequence  of  related  problems, 
which  may  be  nested,  by  the  use  of  partitions,  A terminal  printout 
(OPTIMAL,  UNBOUNDED,  INFEASIBLE,  THETA  or  PHI  AT  MAXIMUM)  is  given  when 
the  vector  set  is  exhausted.  It  is  not  possible  to  have  two  pairs  of 
partitions  simultaneously  active,  but  one  can  alternate  between  tV70 
separated  sets  of  vectors  by  the  use  of  CONTROLS  cards  (and  possible 
sense  switch  2),  For  example,  if  a problem  has  partitions  1 and  2 in 
the  matrix,  then  there  are  6 sets  of  vectors  that  can  be  defined  by 
appropriate  use  of  CONTROLS. 

These  possibilities  are  shewn  in  the  following  table. 


Vectors  Between 


Set 


Announcement  Cards 


A 

B 

C 

D 

E 

F 


MATRIX 
IL^TRIX 
MATRIX 
PARTITION, 1 
PA.RTITION,  1 
PARTITION, 2 


PARTITION,  1 
PARTITION, 2 
FIRST  B 
PARTITION,  2 
FIRST  B 
FIRST  B 


The  sets  can  be  called  for  in  any  order;  SETS  MAY  BE  REPEATED,  IT  IS 
NOT  NECESSARY  TO  USE  ALL  SETS, 
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It  is  almost  always  necessary  to  use  slack  cards  in  the  original 

data  when  Partitions  are  to  be  made  active.  Otherwise  an  infeasible 

29  / 

solution  is  very  likely  to  result. — ' 

Curtain  indices  set  by  a CONTROLS  card  are  also  effective 
only  in  NORMAL,  DO.PLP,  and  DO.PCR,  However,  instead  of  giving  a 
terminal  print  when  the  vector  set  is  exhausted,  the  LP/90  code  "peeks’* 
under  the  curtains  to  find  the  best  vector  outside.  The  curtains  are 
restored  on  the  next  and  subsequent  iterations.  The  activation  and 
numbering  of  curtains  is  completely  independent  of  the  partitions. 

Curtains  are  used  to  influence  the  course  of  iterations  by 
favoring  the  choice  of  vectors  from  the  selected  set;  in  a sparse  problem 
with  a very  large  number  of  vectors  they  may  also  reduce  the  time 
required  for  the  pricing  sequence  in  the  composite  algorithm.  Curtains 
should  not  be  active  during  PLP  and  PCR  since  they  may  cause  dual 
infeasibilities  to  occur. 

COST. RANG INC 

COST .RANGING  provides  the  range  over  which  the  objective 
function  elements  of  the  basis  vectors  can  be  changed  (one  at  a time) 
without  changing  the  optimal  basis ^ The  ranges  for  non-basic  vectors 
are  given  by  the  D/J  values  and  infinity  (see  DO.D/J  below).  This 
routine  is  essentially  the  first  step  of  PCR  and  should  be  used  only 
after  an  optimal  solution. 

The  printout  includes  the  vector  name,  the  BETA  (primal 
solution)  value,  the  original  objective  function  element,  the  minimum 
objective  function  element,  the  maximum  objective  function  element,  the 
vector  entering  the  basis  at  the  minimum,  and  the  vector  entering  the 
basis  at  the  maximijm. 


— See  INPUT  below. 
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COST  .RANGING  ,NAMES 

This  option  of  COST. RANGING  has  the  ability  to  select  a subset  of  the 

problem  vectors  for  analysis.  The  punching  , NAMES  indicates  that 
ranges  are  to  be  obtained  for  the  vectors  with  names  punched  in 
successive  6 character  fields  starting  in  column  7.  Any  punching  in 
cols.  1-6  is  taken  as  the  next  agendum.  No  more  than  m names  may  be 
given  with  one  Ranging  card.  If  the  vector  requested  is  not  in  the 
basis  it  is  ignored.  Cost  Ranges  on  slack  vectors  may  be  obtained  by 
overpunching  the  first  column  of  the  name  with  the  slack  designator 
(»'+”  or 

COST .RANGING ,CLASS 

This  option  is  like  its  predecessor  except  that  it  allows  one 
to  specify  a group  or  "class"  of  vectors  to  be  analyzed  each  member  of 
which  is  identified  by  common  characters « "W"  indicates  the  number  of 

such  classes;  "F"  indicates  the  number  characters  identifying  the 
classes*  This  is  accomplished  as  follows.  The  card  (or  cards)  following 
the  Agendum  Card  contains  W six  character  vector  name  fields.  The 
last  6-F  characters  in  each  field  define  the  vector  classes.  For 
example,  consider  the  following: 


Card  Column 

17  21 

Card  1 

COST . RANG ING , CLAS S , 2 , 3 

Card  2 

lllCOTlllQAT 

Cost  ranging  would,  in  this  example,  be  performed  on  all  vectors  in  the 
optimal  basis  whose  names  ended  in  either  the  three  character  COT  or  OAT. 
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DO.D/J,R,gN,gN 

This  routine  recomputes  the  ^ j i g vectors  (processes 

or  activities)  in  the  LP-matrix  including  slacks.  The  d.,  are  the 

J s 

relative  or  "opportunity"  cost  factors  associated  with  each  activity 
or  process.  They  should  be  "almost"  zero  (i.e.,  x^ithin  the  standard 
tolerance)  for  all  activities  in  the  optimal  basis.  They  should  be 
positive  for  those  vectors  not  in  the  optimal  basis.  For  the  meaning 
of  these  factors  after  an  optimal  solution,  see  Part  II,  this  handbook. 

They  are  computed  by  pre-multiplying  the  LP  matrix  by  the 
row  (n^  vector)  of  the  inverted  basis.  Thus,  in  general,  they  are 
the  row  of  the  LP  matrix  expressed  in  terms  of  the  current  basis. 

If  the  parameter  R (numerical  index  only)  is  specified,  the  rr-vector  is 
recomputed  as  the  R^^  row  of  the  inverse.  Otherwise,  the  existing 
vector  in  P-region  is  used.  The  D/J  routine  is  most  often  employed 
after  an  optimal  solution;  however,  it  may  be  used  at  any  time  to  give 
a row  of  the  current  tableau.  When  the  solution  is  infeasible,  R should 
be  specified  if  the  objective  function  row  is  desired,  since  otherwise 
the  infeasibility  rows  will  be  combined  with  the  functional.  During,  or 
at  the  end  of  PCR,  the  parameter  R should  not  be  specified  so  that  the 
composite  objective  function  row  will  be  obtained. 

The  indicator-parameter  sets  shown  as  gN  are  for  blocking  out 
a certain  part  of  the  A-matrix  for  computing  the  . They  rely  on 
curtains  (g  = C)  and  partitions  (g  = P)  being  in  the  matrix  but  are 
independent  of  the  beginning  and  ending  ones  specified  on  a CONTROLS 
card.  Either  a partition  or  a curtain  may  be  used  either  as  the 
beginning  or  ending  mark.  The  N represents  the  partition  or  curtain 
number  and  may  be  1 to  5 digits. 

If  the  d^  for  the  basis  headings  exceeds  the  standard 
tolerance,  two  asterisks  will  be  printed  alongside  the  vector  name. 

This  routine  may  also  be  called  in  automatically  from  NORMAL 
if  sense  switch  4 is  on  when  an  optimal  solution  is  obtained.  All 
the  d^  are  recomputed  in  full  double  precision  and  checked  to  be  non- 
negative for  all  j and  zero  for  j in  basis  headings  (within  standard 
tolerances).  If  such  is  not  the  case  for  some  j,  the  d.  is  computed 
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again  in  the  reduced  precision  mode  used  in  normal  pricing.  If  it 

still  fails  the  test,  the  d.  is  printed  with  asterisks.  If  this 

J 

occurs,  a halt  is  made  before  continuing  to  the  next  agendum  routine 
(after  appropriate  comment).  If  sense  switch  2 is  put  on,  the  next 
call  card  is  read;  otherwise  NORMAL  is  called  back  in.  If  no  errors 
were  found,  no  printing  is  done,  no  halt  occurs,  and  the  next  call 
card  is  read. 

Sense  switches  (other  than  2 noted  above)  and  the  Pickup  routine 
are  not  effective  in  DO.D/J. 


DO.PLP,C,T,D,K,SPEC  or  DO.PLP,C ,T,D,K,COMP 

DO.PLP  performs  parametric  programming  on  a right  hand  side. 

It  may  be  used  only  after  an  optimal  solution.  The  last  right  hand  side 
optimized  is  the  basic  right  hand  side  (specified  on  the  last  NORMAL), 
and  the  right  hand  side  specified  on  the  DO.PLP  card  is  the  change  vector; 
the  last  objective  function  is  used. 

This  parametric  programming  feature  provides  for  calculating  a 
whole  sequence  of  related  optimal  solutions.  In  effect,  the  restraints 
of  the  system  are  progressively  changed  (in  a specified  ratio)  until 
some  vector  must  leave  the  basis  to  maintain  feasibility.  At  this  point 
a feasible  vector  is  found  to  enter  the  basis  which  will  maintain 
optimality,  the  change  of  basis  is  made,  solution  printing  may  occur, 
and  the  restraints  are  modified  further  until  another  change  of  basis 
is  required.  This  process  is  repeated  until  either  no  further  change 
can  be  made  and  maintain  feasibility  or  a specified  value  is  reached 
(either  event  gives  a THETA  AT  MAXIMUM  message),  or  until  an  ulimited 
change  in  requirements  can  be  made  with  no  further  change  of  basis. 

(THETA  UNBOUNDED  message) . Intermediate  solutions  can  be  obtained  by 
linear  interpolation. 


230 


Nomenclature 


C 

T 


D 


K 


SPEC 

CCMP 


Change  vector  number  (<  9999) 

Maximum  value  of  Theta.  If  given  it  must  contain  a 
decimal  point. 

(Maximum  = 7 digits  plus  decimal  point.  Positive 
value  only.) 

If  T is  omitted  Theta  is  set  at  infinity. 

The  parameter  D (punched  with  decimal  point)  is  an 
(optional)  delta  theta  for  printing.  IJhenever  the 
accumulated  change  in  theta  exceeds  D,  a new  solution 
will  occur  and  the  accumulation,  for  this  purpose, 
starts  over.  This  is  independent  of  the  other  printing 
controls  except  that  the  accumulation  is  set  to  zero 
when  printing  occurs  according  to  F (off-line  solution 
print)  in  CONTROLS.  ® 

Right  hand  side  number  to  be  used  for  new  B when 
Theta  reaches  a maxi.mum.  If  K is  non-zero  B will  go 
to  the  binary  matrix  A**tape  and  be  so  identified. 

If  K = 0 or  blank,  nothing  goes  to  A-tape, 

(Maximum  K < 9999) • 

A command  to  output  K at  the  value  of  theta  given  by 
T even  though  theta  has  gone  unbounded. 

A command  to  output  K at  the  value  of  theta  where 
theta  went  unbounded. 


bbbb  = An  ordinary  “theta  unbounded"  halt  will  occur  and 
K will  not  be  output. 


The  solution  printout  and  the  nex^  right  hand  side  will  be  at 
the  exact  theta  specified  in  the  event  that  a change  of  basis  would 'occur 
if  the  code  were  to  proceed.  If  a maximum  value  of  theta  is  found  prior 
to  the  value  specified,  the  solution  print  and  new  right  hand  side  are 
computed  for  the  value  THETA  MAXIMUM. 

The  capacity  to  save  a composite  right  hand  side  makes  convenient 
complicated  trees  of  parametric  runs.  However,  certain  precautions  are 
necessary.  First,  the  value  qf  "K"  must  not  duplicate  some  already 
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existing  RHS,  (Duplicates  are  given  the  next  available  RHS  number.) 
Second,  if  the  solution  goes  unbounded  the  new  right  hand  side  will 
not  be  produced  unless  the  card  is  punched  ,SPEC  or  ,COMP. 

One  very  effective  use  of  PLP  where  the  intermediate  answers 
are  of  little  interest  is  in  correcting  a model.  Suppose  that  an 
internal  coefficient  must  be  changed  for  some  vector  in  the  basis.  One 
can  multiply  the  level  of  this  vector  by  the  change  in  coefficient 
giving  the  change  in  RHS  which  will  yield  the  same  BETA  levels  as 
previously.  One  can  do  NORMAL  against  this  '*pseudo'*  RHS  and  then 
DO.PLP ,C,1.0  using  the  negative  of  the  change  in  NEXT  B,C.  This 
technique  will  ordinarily  take  much  less  time  than  using  the  composite 
algorithm  to  correct  the  infeasibilities  introduced  by  changing  the 
matrix. 

In  general,  when  using  PLP  one  should  be  very  certain  of  the 

formulation.  For  example,  it  is  common  practice  to  use  less-than-or- 

equal  relations  for  rows  that  are  to  be  met  as  equalities  when  it  s 

"known"  that  the  profit  function  will  drive  the  slack  out.  However, 

during  PLP  a previous  condition  that  is  "known"  may  prove  to  be  violated. 

Thus,  unless  the  row  in  question  is  changed  to  an  equality,  slack  may 

» 

come  into  the  basis.  Sometimes  the  easiest  way  to  do  this  sort  of 
thing  involves  overlaying  or  patching  of  the  restart  cards  from  a 
previous  run. 

Solution  printing  during  PLP  takes  not  only  the  usual  time  to 
v/rite  the  Mediary  tape,  but  also  requires  time  to  bring  in  and  update 
the  right -hand- side  to  the  current  set  of  requirements. 
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On  a Theta  Unbounded  printout  there  is  a column  labelled  GAMMA. 
This  is  the  negative  of  the  change  vector  in  terms  of  the  current 
basis.  All  elements  in  the  restraint  area  will  be  negative  or  zero, 
since  no  positive  ratio  could  be  found  against  the  right  hand  side. 

If  the  answer  for  a larger  value  of  theta  is  desired,  subtract 
(GAMliA)x (the  increase  in  theta)  from  the  Beta  column. 


DO.PCR,Q,P,D 

This  routine  operates  the  same  as  PLP  would  applied  to  the  dual 
problem;  that  is,  the  algorithm  provides  parametric  variation  of  the 
current  objective  function  row.  It  may  be  used  only  after  an  optimal 
solution;  the  basic  objective  function  and  the  right  hand  side  are  those 
previously  used.  The  indication  "Q"  specifies  the  change  row  either  by 
numerical  index  or  by  its  name  preceded  by  « as  in  NORMAL. 

This  use  of  parametric  programming  also  sweeps  out  a whole 
sequence  of  optimal  solutions.  The  objective  function  elements  of  the 
problem  are  progressively  changed  (in  a specified  ratio)  until  some 
vector  must  enter  the  basis  to  maintain  optimality.  Solution  printing 
may  occur  at  each  change  of  basis,  or  at  the  desired  maximum  change; 
intermediate  answers  can  be  obtained  by  linear  interpolation.  The 
algorithm  terminates  when  either  the  incomimg  vector  is  all  negative, 
indicating  an  unbounded  solution  since  no  vector  to  remove  can  be  found, 
or  x^hen  the  specified  maximum  change  is  reached  (PHI  at  MAXniUM) . The 
other  termination  is  PHI  UNBOUNDED;  this  occurs  whenever  an  unlimited 
modification  to  the  functional  can  occur  without  requiring  a change  of 
basis.  (The  d,,  for  the  change  cost  row  will  all  be  positive. 
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Nomenclature 


Q 


Change  rov7  numerical  index  or  name  preceded  by 
asterisk  as  in  NORMAL  (can  be  any  row) • If  Q is 
omitted,  the  previously  used  Q is  in  effect.  If  one 
was  never  specified,  Q = 0, 


P 


Maximum  value  of  Phi.  If  given,  it  must  contain  a 
decimal  point  (maximum  = 7 digits  plus  decimal  point, 
positive  value  only).  If  P is  omitted  (e.g.  ,,), 

Phi  is  set  at  infinity. 


D 


"Delta  Phi"  for  solution  print  when  the  accumulated 
change  in  Phi  since  the  last  print  equals  or  exceeds 
given  value.  (Maximum  = 7 digits  plus  decimal  point. 
Positive  only.) 


The  same  remarks  as  given  under  PLP  apply  to  the  use  of  PCR. 
However,  there  is  no  capability  to  construct  a composite  cost  row 
and  save  it  on  the  binary  matrix  tape. 

All  switches  (except  4),  Pickup,  "in-core"  problems,  etc., 
work  just  as  in  NOP^L.  As  in  PLP  no  curtains  should  be  active  (within 
the  partitions  in  use) and  the  active  partitions  must  not  be  changed  to 
include  more  vectors  during  the  run. 

FIX.VEC,B,K 

The  FIX.VEC  agendum  produces  a modified  RHS  vector  with  index  K, 
This  nev7  RHS  is  the  original  RHS  V7ith  index  B minus  the  LP  matrix 
vectors  multiplied  by  the  levels  specified  on  the  follox^ing  cards  in 
SHARE  standard  format.  Thus  if  B is  the  RHS,  K the  new  RHS,  A the 
LP  matrix,  and  x the  vector  of  specified  constants  then  K = B - Ax. 

A feasible  solution  with  the  resulting  composite  right  hand  side  then 
gives  the  minimum  process  levels  of  the  vectors  as  the  values  specified 
rather  than  zero  as  in  an  ordinary  RHS.  Thus  it  is  possible  to  have 
vectors  essentially  unrestricted  as  to  sign  (by  using  a negative -value) 
or  fixed  at  some  particular  level  (by  leaving  them  behind  a partition) , 
No  more  than  m vectors  can  be  specified  with  one  FIX.VEC  agendum. 
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GETOFF  or  GETOFF,PRINT  or  GETOFF,cu 

This  routine  copies  all  necessary  restart  information  to  the 
mediary  tape  (M-tape)  in  GETOFF  and  GETOFF, PRINT,  In  GETOFF, cu 

restart  information  is  copied  onto  channel  c,  tape  drive 
number  u,  GETOFF, PRINT  also  goes  directly  to  the  output  routine  for 
printing  onto  the  O-tape  the  M-tape  information  for  listing.  In  this 
case  the  run  is  terminated.  Sense  switch  1 may  be  used  in  place  of 
the  GETOFFb  card. 

The  GETOFF's  can  be  used  effectively  in  four  ways:  (1)  as 

an  emergency  measure  to  free  up  the  machine  (GETOFFb);  (2)  as  a problem 
termination  (GETOFF, PRINT) ; (3)  to  save  the  problem  status  at  a desired 

point  for  later  use  in  a complicated  run  agenda  (GETOFF, cu);  (4)  to 

a 

provide  an  extra  copy  of  the  matrix  tape  for /long  run  with  extensive  input 
data  by  using  GETOFF, cu  immediately  after  INPUT  or  REVISE, 

Tapes  are  not  rewound  either  before  or  after  the  GEOFF.  A 
GETOFF  "clobbers”  a portion  of  core  so  that  it  should  be  followed  by 
the  corresponding  RESTART  before  going  on  to  the  next  agendum. 


HEADING  or  HEADING, SAVE 

This  Agendum  is  used  to  begin  a new  problem.  It  causes  all 
control  parameters  to  be  set  to  their  programmed  values  (see  CONTROLS 
above),  and  records  the  problem  identification  punched  in  columns 
13-72  for  later  printing  as  a header  for  each  page  of  output  on  the 
O-tape.  If  HEADING, SAVE  is  used  the  machine  will  print  a message  and 
stop  between  problems  to  enable  the  operator  to  make  tape  unit  changes 
as  required. 

TITLE  performs  much  the  same  function  as  HEADING  except  that  it 
does  not  set  the  control  parameters  (see  TITLE  below). 
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INPUT, q,n, COUNTS, REWIND, PUNCH  or  INPUT, q or  INPUT, q, , LIST, , ETC, 

This  agendum  call  card  initiates  reading  of  the  input  data, 
which  are  converted  to  binary,  packed,  and  written  back  out  on  the 
binary  matrix  tape  (A-tape),  Slack  vectors  are  created  according 
to  the  indicators  on  the  ROW  ID  cards  (see  Part  III),  The  slacks  will 
be  placed  at  the  end  of  the  matrix  unless  otherwise  positioned  by 
SLACK  card.  Elements  having  a row  name  not  in  the  ROW  ID  list  are  sup- 
pressed (not  output  to  the  A-tape),  The  communication  region  in  core 
is  also  set  up  for  the  size  of  the  given  problem  with  proper  initial 
conditions. 

The  letter  q represents  an  integer  which  must  always  be  provided 
by  the  user.  It  is  the  number  of  objective  functions,  all  of  which 
must  appear  at  the  *'top”  of  the  matrix.  For  a single  objective 
function,  q = 1,  All  functional  rows  must  have  a ROW  ID  indicator  of 
0 or  b,  indicating  equality  (see  Part  III), 

The  remaining  items,  n, LIST, REWIND,  and  PUNCH,  are  optional 
controls.  The  letter  n represents  an  integer  which  is  used  for 
getting  to  a particular  problem  on  an  input  tape  on  which  several 
problems  have  been  stacked.  It  is  the  number  of  problems  to  pass  over 
on  the  I-tape,  i.e,,  the  number  of  EOF  cards  to  pass,  before  reading 
the  information. 

The  presence  of  the  actual  punching  LIST  or  COUNTS  is  an  in- 
struction to  print  out  lists  of  row  names  and  column  vector  names 
in  input  order  together  with  the  counts  of  non-zero  elements  in  each 
row  and  column,  excluding  the  right  hand  side  and  sum  row.  These 
lists  are  developed  automatically  in  one  of  the  edit  checks  but  are  not 
output  unless  requested.  If  it  is  desired  to  list  without  skipping 
any  problems  the  card  can  be  punched  either 

INPUT, q,, LIST  or  INPUT , q , 0 , LIST 

The  presence  of  the  actual  punching  REWIND  is  an  instruction 
to  rewind  the  input  tape  (I-tape  only)  when  the  EOF  card  is  encountered. 
Normally  the  tape  is  left  sitting  ready  to  read  more  data.  Again 
REWIND  without  n or  LIST  can  be  punched 

INPUT, q,, RE WIND  or  INPUT, q,0, REWIND. 
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However,  do  not  use  0 to  indicate  the  omission  of  LIST. 

PUNCH  is  an  instruction  to  punch  out  initial  restart  cards. 

This  is  useful  only  on  large  problems  where  the  risk  of  reconverting 
and  re-editing  a large  amount  of  input  data  in  the  event  of  machine 
failure  justifies  the  punching  time. 

On  the  Agendum  Cards  only  the  positions  of  q and  n are  fixed. 
COUNTS  or  LIST,  REWIND,  and  PUNCH  can  be  entered  on  the  card  in  any 
order  after  n (or  its  implied  omission  by  a double  comma). 

INPUT  reads  the  I-tape,  at  whatever  position  it  is  sitting, 

and  expects  to  find  a ROW  ID  indicator  card  (or  a remarks  card  with 

an  asterisk  in  col.  1)  first.  The  ROW  ID  card  can  call  for  another 

30/ 

tape  unit  or  the  card  reader. — If  so,  a ROW  ID  card  is  expected  there, 
also.  Reading  continues  until  a MATRIX  card  is  encountered.  If 
reading  of  the  ROW  ID  was  from  a special  tape  or  card  reader,  it  will 
revert  to  I-tape,  which  will  be  passed  until  a MATRIX  card  is  encountered 
there  also.  Reading  then  continues  until  a FIRST  B card  is  read.  The 
FIRST  B card  may  also  call  for  a special  tape  or  card  reader.  If  so, 
reading  is  switched  and  another  FIRST  B card  expected.  Reading  continues 
until  an  EOF  indicator  card  is  found  which  ends  input  for  the  current 
job.  If  on  an  alternate  unit,  reading  reverts  to  I-tape,  which  is 
spaced  up  until  an  EOF  card  is  also  read  there.  If  more  than  one  reel 
of  input  tape  is  required,  an  on-line  message  is  output  when  a physical 
end-of-file  is  encountered.  (Do  not  use  an  EOF  card  to  end  a reel.) 

The  matrix  is  read  in  column  by  column,  and  each  column  is 
checked  for  duplicate  row  names.  The  entire  matrix  is  checked  for 
duplicate  column  names  at  the  end.  It  is  possible  to  "split**  a vector 
without  giving  a duplicate  vector  check  if  a split  portion  contains 
only  objective  function  elements.  If  more  than  about  7500  columns  are 
present,  the  duplicate  vector  check  will  be  incomplete;  a messfifge  is 
written  giving  the  name  of  the  last  vector  checked. 

Columns  1-30  are  checked  on  each  card  for  characters  not 
meaningful  in  the  card  type  expected.  The  sequences  of  curtains, 

30  / 

— For  example,  ROW  ID,A6  specifies  tape  unit  6 on  channel 
A. ROW  ID,B9  specifies  tape  unit  9 on  channel  B,  ROW  ID,CR  specifies 
card  reader. 
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partitions,  and  right-hand  sides  are  checked  independently  for 
ascending  order o When  an  indicator  card  in  non-ascending  order  is 
encountered  it  is  changed  to  the  next  legitimate  number  and  a message 
written.  The  code  attempts  to  process  all  data  even  though  errors 
are  found.  When  any  errors  have  been  detected  the  code  halts  at  the 
end  of  INPUT;  press  START  will  go  to  the  next  agendum.  Start  with 
sense  switch  3 goes  directly  to  OUTPUT. 

There  are  also  several  optional  input  checking  procedures. 

The  element  cards  are  counted  for  each  column.  This  count  is  then 
checked  against  the  value  given  on  the  CNT  card,  if  present  (see  Part 
III).  The  individual  descrepancies  are  output  off-line  and  the  data 
error  signal  is  turned  on.  Note  that  these  checks  are  made  against 
the  I tape  data,  whether  or  not  some  rows  have  been  omitted  from 
the  ROW  ID  list. 

If  a sum  card  is  present  the  elements  on  the  binary  matrix 
are  summed  and  compared  to  the  value  on  the  SUM  card.  A discrepancy 
does  not  necessarily  indicate  an  error  since  this  check  does  not 
account  for  rows  left  out  of  the  ROW  ID  list.  A separate  on-line 
message  is  given  and  the  individual  descrepancies  are  output  off-line 
if  any  were  found. 

The  use  of  LIST  or  COUNTS  on  the  INPUT  card  causes  output  on 
the  0-tape  of  the  following  information: 

(1)  A list  of  the  assembled  rows  on  the  A-tape,  including 
the  kind  of  row-relation,  together  with  the  number  of 
non-zero  elements  (not  including  the  right  hand  sides). 

(2)  A list  of  rows  not  used. 

(3)  A list  of  vectors  not  used. 

(4)  A list  of  the  structural  vectors,  slacks,  curtains,  and 
partitions  which  were  output  to  the  A-tape,  together  with 
the  count  of  the  number  of  non- zero  elements  in  each 
vector  (not  including  the  sum  row). 

(5)  The  total  number  of  rows,  vectors,  and  non- zero  elements 
in  the  problem,  and  its  density  in  per-cent  of  non-zero 
elements  to  total  possible  elements. 


INTRODUCE ,R,B  or  INTRODUCE  or  INTRODUCE, R or  INTRODUCE,, B 

INTRODUCE  is  an  agendum  which  will  bring  specified  column 
vectors  into  the  basis;  it  is  followed  by  data  cards  containing  the 
names  of  vectors  to  be  introduced.  The  symbols  ”R"  and  "B"  have  the 
same  meaning  and  use  as  in  NORMAL, R,B  except  that  names  are  not 
recognized  for  "R".  That  is,  "R"  is  the  index  of  the  functional 
row  and  '*B*'  is  the  index  of  the  right  hand  side.  Since  optimality 
is  disregarded  during  INTRODUCE,  the  only  effect  of  ”R"  is  to  designate 
the  row  to  use  for  CURRENT  VALUE  on  iteration  prints. 

The  use  of  INTRODUCE  is  related  to  the  use  of  basis  headings 
with  INVERT  or  the  use  of  curtains  in  a matrix.  The  use  of  basis 
headings  in  the  input  data  requires  a preliminary  INVERT.  A curtain, 
when  activated,  will  cause  vectors  ahead  of  it  to  be  introduced  i^ 
they  price  out  profitably,  maintaining  feasibility  or  improving 
feasibility  and/or  optimality.  Vectors  brought  in  by  INTRODUCE,  with 
no  regard  to  optimality,  do  maintain  feasibility  if  it  exists  or  do 
it  the  "least"  violence  otherwise.  There  is  no  guarantee  that  all 
vectors  to  be  introduced  will  remain  at  the  conclusion  of  the  agendimi 
because  one  of  the  later  vectors  may  replace  an  earlier  one.  Thus  the 
order  of  the  vectors  influences  the  final  basis  obtained.  Some  of  the 
requested  vectors  may  not  appear  if  no  ’*pivot"  of  appropriate  sign  and 
magnitude  can  be  found.  A "CAN’T  USE  VECTOR'*  message  is  given. 

The  data  cards  have  the  following  format ; 


Columns 

Vector  Name 

1-6 

(Blank) 

7-12 

YAAAAA 

13-18 

YAAAAA 

19-24 

tr 

25-30 

II 

37-42 

II 

43-48 

II 

49-54 

It 

55-60 

II 

61-66 

II 

67-72 

It 

where  Y = Digit  1-9  or  blank  only  for  structural  vectors; 

for  slack  vectors  Y is  overpunched  with  the  row- 
type  indicator. 

A = Alphanumeric  including  blanks. 

Blank  fields  are  ignored  in  the  reading  of  a card  so  that 
less  than  11  vectors  can  be  supplied  per  card;  however, 
this  means  that  no  comments  should  be  punched  on  these  car 
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All  sense  switches  are  operative  during  INTRODUCE,  but  the 
"iterations  to  stop"  and  the  "etas  to  invert"  from  CONTROLS  are  ignored. 

The  operation  of  the  code  is  about  twice  as  fast  as  NORMAL, 

It  is  therefore  useful  when  an  initial  feasible  solution  is  known  in 
advance  to  be  "near"  the  optimal  solution. 


INVERT  or  INVERT , NO . PUNCH  or  INVERT,  NOT. INCORE 

This  agendum  inverts  the  current  basis.  It  must  be  used  when 
a pre-selected  non-slack  basis  (partial  or  full)  is  specified,  i.e,, 
in  the  data  matrix,  or  by  LDBINARY  (if  followed  by  NORMAL) . Punching 
of  restart  information  occurs  when  INVERT  is  used.  INVERT, NO. PUNCH 
suppresses  this  punching.  INVERT  disregards  curtains  and  partitions 
so  that  vectors  outside  the  active  partitions  may  be  in  the  basis. 

INVERT  can  be  used  for  reducing  the  number  of  tranformat ions 
in  the  product  form  of  the  inverse  and  to  reduce  roundoff  errors.  As 
vectors  are  brought  into  the  basis  in  the  order  in  which  they  are  found 
on  the  A- tape,  the  order  of  vectors  in  the  matrix  seriously  affects  the 
density  of  the  inverse. 

The  INVERT  algorithm  can  be  called  automatically  (without 
using  the  Agendum  Card)  after  a fixed  number  of  iterations  by  use  of 
the  CONTROLS  Agendum  (See  above) , The  optimum  inversion  frequency 
occurs  when  the  average  time  per  iteration,  including  the  time  for 
inversion,  reaches  a minimum.  After  the  first  INVERT,  this  frequency 
is  maintained  by  testing  the  clock  at  each  on-line  print  and  inverting 
when  the  average  time  per  iteration  becomes  more  than  1%  greater  than 
the  minimum  average  time  computed, 

INVERT, NOT. INCORE  changes  an  "in  core"  problem  to  an  "out  of  core" 
problem  and  inverts  the  current  basis.  This  agendum  should  be  used  if 
excessive  inverts  are  required  for  a problem  that  would  ordinarily  be 
solved  "in  core," 

INVERT  cannot  be  interrupted  and  then  restarted.  Only  sense 
switches  2,  5 & 6 are  recognized  during  INVERT  to  be  abandoned  and 
another  call  card  read,  but  the  job  will  not  be  salvageable  except  by 
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reloading  the  punch-outs  produced  at  the  beginning.  Switch  5 will 
cause  on-line  "cycle  printing"  as  usual,  but  the  headings  are  incorrect; 
it  is  useful  in  debugging  system  or  machine  troubles.  The  output 
format  is  fully  described  below.  Sense  switch  6 enables  the  user  to 
obtain  an  on  line  solution  print  for  checking  in  the  event  an  error 
is  found  in  the  solution. 

INVERT  can  fail  if  a singular  basis  is  somehow  specified  in 
the  basis  headings.  When  a column  that  is  a linear  combination  of 
the  columns  already  introduced  is  found,  the  caption  "MATRIX  SINGULAR  S 

VECTOR  DELETED " is  printed  on-line  and  the  machine  halts.  If 

sense  switch  5 is  put  down  and  START  is  hit  the  particular  linear 
combination  which  forms  the  singular  column  which  is  listed  on  the 
0-tape.  If  sense  switch  5 is  up  and  START  is  hit  the  code  ignored  this 
vector  and  goes  on  to  the  next. 

INVERT  can  also  fail  to  find  vectors  for  all  basis  headings. 

In  this  case  a halt  and  message  occur.  The  missing  vectors  can  be 
ignored  by  pressing  start.  They  are  listed  off-line. 


LDBINARY 

This  agendum  loads  the  binary  punch-out  cards  from  a previous 
run  of  the  same  or  similar  problem.  The  binary  punch-out  must  have 
the  leading  card  removed.  (This  card  contains  BCD  descriptive  information.) 
The  last  six  binary  cards  contain  problem  constants  from  the  Communication 
Region.  They  include  the  right-hand  side  in  use,  q,  the  number  of 
rows  in  the  problem,  and  the  number  of  records  on  the  A-tape  as  well 
as  the  previous  setting  of  the  control  parameters.  The  last  card  of 
the  punch-out  is  often  blank  in  cols.  1-72;  if  not,"  one  blank  cai^d 
must  be  supplied  to  terminate  the  loading  of  the  binary  cards. 

Hollerity  information  punched  in  columns  13-72  of  the  LDBINi^Y 
Card  will  replace  the  problem  ID  (from  a prior  HEADING).  If  the 
LDBINARY  card  is  blank  in  cols.  13-72,  the  old  ID  is  retained.  Thus 
one  special  use  of  LDBINARY  is  to  retitle  a run;  in  this  case  the 
agendum  can  be  followed  immediately  by  one  blank  card. 
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If  only  the  matrix  or  right-hand  side  data  change,  but  not 
the  ROW  id's,  LDBINARY  can  follow  INPUT, q or  REVISE, q.  In  this  event 
it  may  be  necessary  to  remove  the  last  6 binary  cards  due  to  their 
being  inconsistent  with  the  changes.  If  changes  in  the  action 
parameters  are  needed  use  CONTROLS  after  LDBINARY. 

If  no  changes  are  required  and  the  A-tape  (binary  matrix) 
exists,  the  run  should  be  started  with  LDBINARY  instead  of  INPUT, q or 
REVISE, q.  In  this  case  the  last  six  cards  must  be  retained. 

If  REVISE  is  to  be  used  to  add  ROW  ID's,  and  an  old  basis  is 
desired,  use  LDBINARY  prior  to  REVISE. 


LDHREG 

This  agendum  loads  the  binary  punchout  cards  followed  by  one 
blank  card  from  a previous  run  symbolically  into  H-Region.  Only  bais  head 
ings  may  be  loaded  with  this  agendum  since  it  matches  row  names 
with  those  obtained  from  the  ROW  ID  cards.  If  a match  occurs,  the 
corresponding  vector  name  is  taken  from  the  card.  If  no  match  is  found 
the  vector  is  ignored. 

This  agendum  should  be  preceded  by  INPUT  or  REVISE  to  establish 
the  Communication  Region  and  the  ROW  ID  region. 

One  special  use  of  this  agendum  is  to  merge  the  optimal  bases 
of  two  or  more  subproblems  to  give  a starting  solution  for  the  overall 
problem.  A precaution  that  must  be  observed  to  obtain  a feasible 
solution  is  that  the  active  constraint  rows  of  each  subproblem  must  be 
distinct . 
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LP4290 , V ,X , REWIND ,ALL 

This  converts  704  SCROL  input  on  tape  A6  to  LP/90  input  on 
I-tape,  Negative  slacks  are  not  recognized  and  will  be  carried  as 
ordinary  vectors  with  the  corresponding  rows  handled  as  equaJ.ities. 
Slack  cards  will  replace  UP*s  as  encountered  on  the  SCROL  tape.  The 
ROW  id's  for  LP/90  are  created  from  the  SCROL  Basis  when JC  = 0 so  that 
this  option  will  not  work  unless  all  UP's  are  in  the  SCROL  Basis 
Headings. 

Nomenclature 

V = 0 means  fixed  field  SCROL  data 

V = 1 means  variable  format  SCROL  data 

X = 0 means  ROW  ID's  from  SCROL  UP's  in  Basis 

X = 1 means  ROW  ID's  from  card  reader 

RET‘7IND  causes  a rewind  of  the  SCROL  tape 

ALL  is  needed  to  process  multiple  SCROL  jobs  to 

multiple  LP/90  jobs. 

A corresponding  code,  CONVERT,  has  been  distributed  by  SHARE 
for  the  704  EDPM  that  takes  LP/90  input  to  704  SCROL  format. 


*MDLW , CODES  ,REGNS , BUFFS 

This  routine  dumps  the  specified  portions  of  memory.  The  punch- 
ing,,CODES  calls  for  the  Actuator,  System  Routines,  and  current  agendum 
with  mnemonic  operation  symbols.  The  punching  ,.REGNS  calls  for  H- region 
in  BCD  and  the  other  regions  in  octal.  The  Communication  Region  is 
always  given  in  octal,  MDUMP,bbbbb  gives  only  the  communication  region. 
The  code  operates  in  two  phases  when  called  for;  first,  the  designated 
portion  of  core  are  put  in  binary  on  the  mediary  tape,  then  at  OUTPUT, 
these  regions  are  translated  as  above.  MDUMP,  leaves  core  unchanged 
so  that  the  run  may  be  continued  with  any  agendum.  The  order  of  the 
words  CODES, REGNS, BUFFS  is  immaterial. 
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NEW,  BAS  IS  or  NEW.  BAS  IS , MOD 

This  agendum  may  be  used  for  two  purposes:  (1)  to  insert  the 

names  of  vectors  that  would  comprise  a full  basis  (except  for  slacks); 
(2)  to  overwrite  some  particular  column  name  or  names  without  dis- 
turbing the  balance  of  the  current  basis. 

Option  (1)  is  called  for  by  the  agendum  having  only  NEW, BASIS 
punched  in  col.  1-9,  The  code  will  then  clear  all  basis  column  names 
and  restore  only  slack  variables  to  their  proper  positions  in  much  the 
same  manner  as  they  would  be  after  INPUT, q.  The  cards  following  are 
punched  in  the  same  manner  as  the  BASIS  cards  for  INPUT, q,  i.e,,  up  to 
5 pairs  per  card,  the  number  of  pairs  in  col.  6,  and  a pair  consists  of 
12  columns  the  first  6 of  which  are  the  vector  name  and  the  balance  the 
row  name.  (Cols.  1-5  must  be  blank).  If  a slack  is  to  be  replaced, 
it  is  necessary  to  specify  a vector  to  come  into  that  row  position.  If 
no  row  name  is  specified  with  a vector  name  (the  row  name  field  being 
blank),  the  vector  will  be  assigned  to  the  first  artificial  position 
available. 

In  option  (2)  the  agendum  card  must  be  punched  NEW, BASIS, MOD 
in  columns  1 to  11.  This  does  not  disturb  the  current  basis  except  to 
overlay  the  headings  corresponding  to  the  row  positions  specified  in 
the  following  cards  with  the  vector  names  given.  The  format  of  the 
cards  that  follow  is  exactly  as  in  option  (1). 

The  next  agendum  following  the  basis  cards  in  either  option 
must  be  INVERT. 

Option  (1)  may  be  used  to  make  a transition  from  SCROL  to 
LP/90,  or  to  specify  an  advanced  basis  in  Hollerith  card  form  because 
the  binary  start  cards  are  not  available.  A use  for  option  (2)  is 
the  switching  of  one  or  two  vector  names  in  a basis  before  inversion. 
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NORMAL  or  NORMAL, R,B  (R  = 0,  B = 1) 

(NORMAL, R or  NORMAL,, B are  also  possible.) 

This  main  composite  algorithm  tries  to  find  a feasible  solution, 
if  not  provided,  and  then  an  optimal  solution.  If  an  optimal  solution 
is  reached,  the  next  agendum  card  is  called  for  automatically.  If  *’no 
feasible  solution”  exists,  or  an  '’unbounded  solution”  is  found,  pro- 
cessing is  stopped  for  operator  action.  On  "no  feasible  solution” 
the  next  agendum  will  be  read  by  pressing  START  twice , 

NORMAL, R,B  uses  the  functional  with  numerical  index  R and  the 
right  hand  side  with  numerical  index  B.  The  name  of  the  row  can  be 
substituted  for  the  index  by  preceding  the  name  with  *,  as  in 
NORMAL, *1C0STS ,2  if  either  R or  B or  both  are  blank,  the  R and/or  B 
from  the  previous  NORMAL  is/are  used.  INPUT, q,  and  REVISE, q,  put  the 
highest  numbered  functional  in  R and  the  first  right  hand  side  in  B. 
REVISEb  and  LDBINARY  leave  existing  values  unchanged;  however,  note 
that  the  last  6 binary  cards  of  a punch-out  also  contain  this  information 
and  if  loaded  by  LDBINARY  reset  it  accordingly, 

NORMAL  is  required  prior  to  PLP  or  PCR  runs  to  set  the  current 
right -hand- side  and  functional  indices.  In  most  cases  it  is  also  needed 
to  insure  the  optimal  solution  required  to  start  PLP  or  PCR. 


OUTPUT  or  OUTPUT , OLD 

This  agendum  processes  the  binary  information  on  the  Mediary 
Output  Tape  CM-tape  into  a final  BCD  output  tape  fot  printing  off-line 
or  on  the  1401  computer.  It  is  followed  by  an  irretrievable  halt. 

The  OUTPUT, OLD  option  was  designed  primarily  in  event  of  trouble 
to  convert  the  binary  Mediary  output  tape  to  BCD  output.  It  assumes 
the  Mediary  tape  has  been  End- of- Filed  and  rewound,  whereas  the  OUTPUTb 
agendum  writes  the  EOF  and  rewinds  the  tape. 


PUNCH 
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PUNCH  punches  out  restart  information  about  the  current  basis 
on  binary  cards  to  be  loaded  behind  LDBINARY, 

The  initial  card  is  Hollerith  and  contains  iteration  count 
(columns  2-5),  eta  count  (columns  6-9),  and  heading  identification 
(columns  13-72),  In  subsequent  cards,  the  iteration  count  appears 
in  columns  73-76  and  the  eta  count  is  in  columns  77-80.  Note  that 
these  fields  are  dependent  on  the  Punch  Board  wiring. 

The  next  cards  are  absolute  loading,  row-binary,  23-word  cards 
containing  basis  heading  names  and  row  identification  (H-region) , The 
last  6 cards  contain  parameter,  buffer  size,  and  other  information 
(K-region).  For  use  of  the  punch-out  cards  see  LDBINARY. 


RESET 


Reset  theta  (for  PLP),  phi  (for  PCR)  the  right  hand  side, 
change  vector  number,  and  change  cost  row  to  zero.  It  must  be 
used  after  DO. PLP  or  DO, PCR  unless  the  latter  has  been  interrupted 
by  the  use  of  CONTROLS,  INVERT,  etc.,  and  the  same  parametric 
computation  is  to  be  resumed. 


RESTART  or  RESTART, cu 

The  two  forms  of  RESTART  correspond  to  the  several  ways  of 
doing  a GETOFF,  The  indicators  "cu'*  stand  for  channel  and  tape  unit. 

The  following  procedures  may  be  used: 

1.  GETOFF 

RESTART  (Also  functions  as  ASSIGN) 

This  sequence  is  primarily  an  operator  option  to  make  the 
machine  available  to  another  user.  After  RESTART  the  Mediary 
tape  is  positioned  correctly  at  the  end  of  the  last  record 
before  the  GETOFF. 
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2.  GETOFF, PRINT 

CCMITROLS  (may  be  blank) 

RESTART, cu  (also  acts  as  ASSIGN) 

(Note  that  the  mediary  tape  from  GETOFF, PRINT  may  be 
mounted  on  an  alternate  unit  for  RESTART, cu.) 

This  sequence  may  be  called  for  on  a long  job  where  the 
first  answers  are  of  interest.  The  purpose  of  the  CONTROLS 
card  is  merely  to  insure  that  the  new  mediary  tape  is 
started  properly.  This  will  not  occur  if  RESTART  is  first. 

A heading  card  is  not  necessary  unless  it  is  desired  to 
change  the  problem  ID,  in  which  case  ijt  comes  first,  followed 
by  CONTROLS.  (The  old  heading  will  print  on-line,  the  new 
one  off-line), 

3.  GETOFF, cu 

CCWTROLS  (may  be  blank) 

RESTART, cu  (also  functions  as  ASSIGN) 

This  sequence  may  be  called  for  when  a long  complicated  run 
is  not  completed  in  a single  pass  on  the  machine.  The 
comments  for  case  2 also  apply  here  since  the  run  was  broken, 

4.  GETOFF, cu 

RESTART, cu  (also  functions  as  ASSIGN) 

(subsequent  agenda) 

RESTART, cu  (also  functions  as  ASSIGN) 

This  sequence  is  primarily  for  formulator  use  in  setting  up 
a complicated  agenda.  Leave  columns  13-18  blank  so  that 
the  ASSIGN  option  is  not  inadvertantly  used.  Neither  HEADING 
nor  CONTROLS  should  immediately  precede  the  RESTART  since 
they  will  be  ineffective. 


REVISE  or  REVISE, q 


The  REVISE  agendum  is  a second  input  routine  and  takes  the  same 
formats  as  INPUT  with  one  or  two  exceptions.  It  has  three  primary 
functions  and  these  should  not  be  confused. 

Function  A:  REVISEb  modifies  and/or  extends  the  matrix  and/or 

RHS's  on  an  existing  A-tape.  In  the  diagram  below  the  solid  lines 
represent  an  existing  model.  The  X's  indicate  element  changes  and 


the  dotted  lines  indicate  new  rows  and  columns.  The  wavy  lines  indicate 
existing  curtains  or  partitions.  The  "ones”  indicate  slack  vectors. 
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In  this  use  of  REVISE,  a Communications  Region  setup  consistent 
with  the  A-tape  to  be  revised  is  assumed  and  the  following  restrictions 
should  be  noted: 

(1)  Existing  rows  cannot  be  deleted  nor  re-named,  nor  can 
their  slack  indicators  be  changed. 

(2)  Existing  curtains  and  partitions  cannot  be  removed  nor 
can  new  columns  be  inserted  ahead  of  them, 

(3)  Existing  slacks  cannot  be  removed  and  all  new  columns 
will  be  added  after  them.  Therefore  an  active  ending 
partition  can  seldom  be  used, 

(4)  New  slacks  required  by  new  R0V7  ID*s  (if  any)  will  be  at 
the  end  of  the  new  matrix. 

(5)  Old  RHS*s  cannot  be  removed  but  their  elements  can  be  changed 
in  any  way.  New  RHS's  will  follow  old  ones  and  hence  must 
have  higher  ID  numbers.  NEXT  Bbb  is  not  allowed.  If  a 

new  RHS  with  index  N is  out  of  sequence  then  precede  the 
NEXT  B,N  card  with  NEXT  B,N-1. 

(6)  New  curtains  and  partitions  cannot  be  defined,  even  among 
the  new  columns.  Existing  curtains  and  partitions  cannot 

be  changed  or  removed.  Of  course,  they  can  be  made  inactive 
by  a subsequent  CONTROLS  card,  * 

(7)  The  ordering  of  new  columns  (v/hich  must  in  any  event  follow 
all  old  ones)  can  only  be  controlled  by  their  order  of 
input,  i.e,,  a column  name  is  assigned  the  next  position 
when  it  is  first  encountered. 
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(8)  If  a BASIS  card  is  used,  the  following  Basis  Headings  can 
refer  to  either  old  or  new  ROW  ID’s  and  old  or  new  columns. 
However,  it  is  strongly  recommended  that  Basis  Headings 
refer  only  to  new  rows  and  nevz  columns.  This  function 

of  REVISE  must  be  followed  by  INVERT  and  the  user  should 
be  able  to  guarantee  non- singularity  of  the  new  basis, 
if  possible.  If  Basis  Headings  are  not  supplied,  new  basis 
positions  will  be  filled  with  slack  or  artificial  names, 
as  appropriate.  BASIS  is  not  allowed  if  ^ new  rows  added. 

(9)  In  particular,  the  COL  ID  option  must  not  be  used  with 
Function  A. 

(10)  If  existing  non- zero  matrix  elements  are  to  be  changed  to 
zero,  a zero  element  card  must  be  supplied  and  the  zero 
element  will  occupy  space  on  the  A-tape,  This  will  cause 
no  difficulty  except  in  the  event  that  all  constraint 
elements  in  the  column  become  zero,  and  even  then  only 

if  the  objective  function  elements  are  negative.  Of 
course,  there  is  always  the  danger  of  revising  the  existing 
basis  in  such  a way  as  to  make  it  singular,  whether  by 
zero  elements  or  not. 

(11)  If  all  the  elements  of  a vector  are  to  be  revised  to  zero 
the  vector  can  be  deleted  by  placing  a DELETE  card  follovzed 
by  cards  with  the  name  (names)  of  the  vector (s)  to  be 
deleted,  one  per  card,  in  cols.  7-12  immediately  prior  to 
the  MATRIX  card.  This  option  is  only  effective  if  at  least 
one' additional  matrix  change  is  being  made. 


Function  B:  REVISE, q selects  rows  and  columns  of  an  existing 

problem  on  I-tape,  furnishes  RHS*s,  and  creates  the  A-tape  for  a 
particular  run,  ordered  in  a specified  way.  In  the  diagram  below  the 
solid  lines  represent  an  existing  comprehensive  matrix  in  BCD  form 
with  elements  in  any  order.  The  dotted  lines  indicate  the  selected 
ordered  matrix  (with  curtains  or  partitions  placed  as  desired)  and  the 
RHS's  furnished.  If  desired,  the  RHS's  can  be  standard  and  follow  the 
matrix  on  I-tape  in  the  usual  fashion.  They  cannot  be  selected  by 
REVISE  as  columns  but  elements  corresponding  to  specified  rows  will 
be  selected. 

Matrix  (Slacks)  RHS's 
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In  this  use  of  REVISE,  the  following  restrictions  should  be  noted 

1,  An  existing  A-tape,  mounted  on  the  machine  will  be  over- 
written. 

2,  The  I- tape  or  alternate  input  tape,  must  not  contain 
CURTAIN  or  PARTITION  cards  in  the  body  of  the  matrix. 

(They  are  intermixed  with  column  ID*s.) 

3»  All  slacks  are  placed  in  order  at  the  end  of  the  matrix. 

They  cannot  be  placed  ahead  of  curtains  or  partitions. 
Therefore  active  partitions  are  of  little  use. 

Function  C;  To  put  together  an  A-matrix  and  RHS*s  whose  elements 
are  furnished  in  random  order,  either  with  or  without  column  order 
specified  (but  with  toi-j  order  specified,  whether  important  or  not.) 

This  is  clearly  a special  case  of  Function  B but  may  be  an  important 
one  for  processing  BCD  output  of  other  routines,  such  as  a matrix 
generator.  The  following  restrictions  should  be  noted.  (They  apply 
to  all  Functions) : 

1.  Row  ID*s  must  be  entered  first. 

2.  All  matrix  elements  must  be  between  the  MATRIX  AND  FIRST  B 
indicators. 

3.  Each  right  hand  side  must  be  entered  as  a batch  in  the 
order  desired.  The  order  of  elements  within  a batch  is 
immaterial. 

In  all  three  functions  the  following  remarks  are  relevant, 

1.  The  write-up  on  INPUT  (page  7)  down  to  and  including  section 
5 (page  10)  applies  to  REVISE  also.  In  addition  there  is  an  indicator 
card  punched  COLbID  in  card  columns  1-6  which  REVISE  recognizes  as 
announcing  column  ID  cards.  These  latter  cards  are  similar  to  ROW  ID 
cards  except  the  column  name  is  punched  in  columns  7-12  and  columns 
13-18  are  ignored.  The  column  ID*s  specify  the  desired  set  and  order 
of  matrix  Columns  desired,  just  as  R0^7  ID’s  do  for  rows.  Note  that 
column  id’s  may  not  be  used  for  function  A.  They  are  optional  in  any 
event , 
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2.  PARTITION  and  CURTAIN  cards  have  the  same  format  and 
function  as  with  INPUT  but  may  be  used  only  with  column  ID*s,  Simply 


insert  the  cards  between  column  names  as  desired.  They  must  not 
appear  among  matrix  elements. 

3,  The  option  for  reading  5 pairs  of  names  per  card  applied 

only  to  Basis  Headings,  Column  ID  and  ROW  ID  cards  must  contain  only 

one  row  name  per  card  and  must  be  blank  in  card  columns  1-6  for  REVISE. 
Card  columns  19-80  are  ignored, 

4,  The  CNT  and  SUM  cards  will  be  passed  but  ignored  by  REVISE, 

Similarly,  no  split  vector  check  is  possible  since  they  are  eliminated 
by  the  sort  in  REVISE,  If  two  element  cards  have  the  same  row  and 
column  names,  the  last  one  will  be  used,  i.e,,  it  will  overwrite  pre- 
ceding ones.  This  is  true  for  any  RHS  also, 

5,  SLACK  cards  must  not  be  used  with  REVISE, 

6,  The  option  to  use  alternate  input  units  applies  to  REVISE 
in  exactly  the  same  way  as  with  INPUT. 

7,  Function  A is  distinguished  from  Functions  B and  C in  the 
following  way.  If  the  agendum  card  is  punched  REVISE  in  card  columns 
1-6  with  column  7 blarJ^.  this  indicates  Function  A,  The  existing 
matrix  on  A- tape  will  be  revised  according  to  BCD  information  on  I- tape, 
which  may  in  turn  call  for  an  alternate  unit,  REVISE  expects  to  find 
either  a remarks  card  (*  in  col.  1)  or  a ROW  ID  card  ready  to  be  read 
on  I- tape.  Remarks  cards  preceding  the  ROW  ID  card  are  not  printed. 

If  no  ID  card  is  used,  the  first  indicator  must  be  DELETE,  MATRIX, 
FIRST  B or  NEXT  B.  In  the  latter  two  cases,  the  matrix  is  merely 
copied  from  A-tape.  The  new  matrix  and  RHS*s  are  written  on  B-tape. 
DELETE  is  always  followed  by  MATRIX  since  a matrix  change  is  required. 
Finally,  the  unit  designations  for  A-tape  and  B-tape  are  interchanged 
in  the  coninunications  region.  The  communication  region  and  all  storage 
assignments  are  updated.  The  RHS  number,  however,  is  unchanged  and 
existing  basis  headings  in  core  are  not  disturbed.  The  next  major 
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agendum  card  must  be  INVERT,  Exception:  CONTROLS,  SCALE,  etc.,  can 

intervene.  Control  parameters  are  not  reset  by  REVISEb.  The  "FIRST  B" 
RHS  is  left  in  B region. 

8,  Functions  B and  C are  distinguished  from  Function  A in 
the  following  way.  If  the  agendum  card  is  punched 

REVISE, q 

in  columns  1 to  8 (or  9 if  q > 10),  this  indicates  Function  3 or  C. 

The  parameter  n and  indicators  REWIND,  PUNCH,  LIST,  can  also  be  used 
in  this  case  just  as  with  INPUT, q.  However,  the  output  resulting  from 
LIST  is  much  less  elaborate  with  REVISE ,q,  consisting  merely  of  the 
column  names  in  the  order  used.  (COUNTS  is  not  recognized  and  causes  a 
halt.)  REVISE, q expects  to  find  a remarks  card  or  a ROW  ID  card  ready 
to  be  read  from  I-tape.  In  this  case,  ROW  ID  must  be  present.  If 
COL  ID  is  used,  it  follows  the  Basis  Headings,  if  any,  or  else  ROW  ID*s, 
In  any  case  DELETE  may  not  be  used  in  Function  B and  C.  The  matrix 
and  RHS's  are  written  on  A-tape  and  core  is  left  as  it  would  be  by 
INPUT.  (The  first  RHS  is  left  in  core.)  Control  parameters  are  reset 
by  REVISE ,q. 

9.  Where  not  contradicted  by  the  foregoing,  further  details 
found  in  the  v/rite-up  of  INPUT  apply  to  REVISE  also, 

10.  There  is  an  upper  limit  to  the  total  number  of  new  elements 
which  REVISE  can  handle.  This  is  imposed  by  the  sort  routine  and  is  in 
the  range  of  4800-5000  elements,  depending  on  the  number  of  rows. 


RHS. RANGING  or  RHS  .RANGING, NAMES  or  RHS  .RANGING , CLASS ,W,F 

RHS. RANGING  provides  the  range  over  which  the  values  of  the 
RHS  vector  can  be  changed  (one  at  a time)  without  requiring  a change 
of  basis  to  maintain  feasibility.  This  routine  is  essentially  the 
first  step  of  PLP  and  should  be  used  only  after  an  optimal  solution. 
Like  COST, RANGING  it  has  the  ability  to  select  a subset  of  the  problem 
(rows)  for  analysis. 
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The  print-out  includes  the  row  name,  the  Pl-value  (dual 
variable),  the  original  right -hand- side  element,  the  minimum  RHS 
element  value,  the  maximum  RHS  element  value,  the  vector  leaving  the 
basis  at  the  minimum,  and  the  vector  leaving  the  basis  at  the  maximum. 

Nomenclature 

The  punching  , NAMES  indicates  that  ranges  are  to  be  obtained 
for  the  Row  Names  punched  on  the  following  cards  in  INPUT- INTRODUCE 
format.  (Row  names  in  successive  6 character  fields  starting  in 
column  7.)  Any  punching  in  col.  1-6  is  taken  as  the  next  agendum. 

No  more  than  m names  may  be  given  with  one  Ranging  card.  If  the  row 
requested  is  not  above  q in  the  basis  it  is  ignored, 

, CLASS, W,F  sets  up  a group  of  w columns  starting  in  column 
F + 1 of  the  name  field,  (That  is,  F is  the  number  of  columns  to  skip.) 
The  following  cards  then  define,  starting  in  column  7,  successive  6 
character  fields  containing  in  the  group  w the  class  characters. 

All  rows  in  the  basis  having  the  designated  class  characters  in  the 
corresponding  columns  are  used. 

Examp le : 

RHS  . RANG  INC  , CLAS  S , 2 , 3 

ABCDEFG  lb lb lb lb  — b 

All  rows  with  either  CDE  or  bib  in  positions  345  of  the  row  name  will 
be  chosen  if  they  are  in  the  basis.  Other  vectors  will  be  ignored. 
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SCALE, S 

This  in  effect  multiplies  the  objective  function  row  elements 
by  the  value  specified  as  S,  Any  number  other  than  zero  must  be 
punched  with  a decimal  point,  A blank  terminates  reading.  If  the 
number  is  negative,  the  minus  sign  comes  first.  Examples: 

SCALE, .001  i.e,  .XXX 

SCALE, -1,  i.e.  -X. 

SCALE, 0 or  SCALE, 

(Dec.  Pt,  not  necessary  for  zero.) 

Negative  scale  factors  are  used  to  reverse  the  sense  of 
optimization  (see  Part  II  of  this  manual),  A scale  factor  of  ,001 
effectively  makes  the  D/J  tolerance  greater;  that  is,  the  solution 
will  be  said  to  be  optimal  after  fewer  iterations.  On  the  other  hand, 
a scale  factor  of  1000  effectively  makes  the  tolerance  smaller  so 
that  more  iterations  will  be  required  to  reach  "optimxjm.” 

The  current  scale  factor  in  use  is  printed  in  the  profit  row 
of  the  PI  column  on  output. 

^Another  use  of  SCALE, S is  to  over-ride  the  initial  setting 
of  the  scale  factor  by  INPUT,  Thus,  a composite  weighting  of  infeasible 
constraints  and  the  objective  function  row  can  be  obtained.  The  NORMAL 
composite  algorithm  v/ill  set  the  scale  factor  to  zero  if  the  objective 
function  dominates  the  infeasibilities  so  that  no  more  vectors  can  be 
chosen.  Therefore,  scale  factor  should  be  set  to  the  largest  value 
possible  that  will  not  be  changed  to  zero  by  the  composite  algorithm. 

For  many  problems  a typical  value  of  ,1  or  ,01  will  result  in  appreciably 
fewer  iterations  required  to  reach  optimal. 


STATUS 


STATUS  gives  on-line  and  off-line  the  status  of  all  the  parameters 
set  by  CONTROLS,  the  current  value  of  all  TOLERANCES,  the  current  and 
saved  scale  factors,  and  the  current  RHS  number.  The  tolerances  are. given 
as  a power  of  two  since  in  most  cases  they  are  carried  as  a floating  point 
characteristic  with  no  mantissa. 
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TABLEAU  or  TA3LEAU,NAMES  or  TABLEAU, INVERSE  or  TABLEAU, FROMYAAAAA 


This  routine  transforma  the  entire  L.Po  matrix  or  a specified 
subset  of  it  into  terms  of  the  current  basis,  Printii^then  occurs 
six  columns  at  a time  excluding  the  current  basis  (which  is'  merely  the 
identity  matrix  after  transformation).  The  process  can  be  quite 
time-consuming  even  on  moderate  problems,  so  that  an  entire  tableau 
cannot  be  recommended  as  a standard  operating  practice.  For  this 
reason  several  modifiers  have  been  included  to  restrict  TABLEAU  to 
certain  specified  subsets,  i.e.. 


TABLEAU 


This  multiplies  the  inverted  basis  times  each  column  not 
in  the  basis.  If  we  let  P"^  be  the  inverted  basis  then 
each  column  of  the  tableau  say  a|,  will  be 


Where  a.  is  a column  not  in  the  basis-  The  tableau 

columns'^  a',  give  the  vectors  that  enable  one  to  express  the 
original  *'  LP  matrix  columre  as  a linear  combination  of 
the  columns  in  the  basis.  Thus  a.  = Pa|. 


TABLEAU , FROMYAAAAA 


This  gives  the  same  information  as  TABLEAU,  except  that 
the  tableau  is  computed  only  for  the  columns  beginning  with 
that  named  YAAAAA  and  ending  with  the  last  one  in  the 
currently  active  partition.  If  YAAAAA  is  a Slack  vector 
name  place  an  over  punch  (+  or  - depending  on  the  slack 
type)  over  the  first  character  Y (even  if  it  is  blank). 


TABLEAU., NAMES  Same  as  TABLEAU  except  tableau  is  computed  only  for  the 
columns  (not  in  the  basis)  identified  on  the  following 
cards.  The  vector  names  are  punched  in  contiguous  fields 
of  six  characters  each  beginning  in  column  7.  No  more 
than  2M+2  columns  are  permitted.  Slack  vectors  are  freated 
as  in  TABLEAU, FROMYAAAAA. 

TABLEAU, INVERSE  or  TABLEAU,! 

This  usage  outputs  the  non- slack  columns  of  the  inverse 
of  the  current  basis. 


TABLEAU  has  a special  output  format.  There  are  seven  columns 
on  each  page.  The  first  three  are  headed  by  column  names  except  for 
TABLEAU, INVERSE  when  they  are  headed  by  row  names.  The  fourth  column 
is  headed  by  J(H)  (see  OUTPUT)  and  the  last  three  are  again  vector  names. 
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TABLEAU  or  its  options  may  be  called  at  any  time.  When  used 
after  REVISE  or  REVISE, q it  is  the  only  way  to  obtain  a complete, 
exact  record  of  the  problem  actually  solved. 

This  Agendum  is  particularly  hard  on  tapes  and  on  large 
problems  tape  errors  are  common.  If  failure  occurs  TABLEAU  is  terminated 
and  the  list  of  six  vectors  in  possible  error  pointed.  Output  will 
be  obtained  on  the  already  processed  correct  portion  so  that  the 
problem  can  be  completed  by  using  TABLEAU, FROMYAAAAA  starting  with 
the  first  bad  vector. 


UNSCRAMBLE 

This  re-orders  the  basis  headings  and  corresponding  beta  values 
on  the  M-tape  to  the  order  of  the  ROW  ID, 
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2.  PROPRIETARY  (PROP)  AGENDA 


ADDRHS,cu 

The  purpose  of  this  routine  is  to  provide  an  alternative  to 
REVISE  for  getting  additional  right-hand- sides  directly  to  the  A-tape. 
Thus  entry  of  change  vectors  for  PLP  can  be  made  from  the  card-reader 
(CR)  or  from  a specified  tape  (u)  on  channel  (c) , The  data  format  is 
the  same  as  that  for  I- tape  input;  the  first  card  is  NEXT  B,N  and  the 
last  is  EOF. 

It  is  the  programmer's  responsibility  to  specify  right-hand-side 
numbers  which  are  larger  than  those  already  on  the  A-tape  since  no 
checking  for  duplicates  is  made. 


A.TO. I, cu, REWIND, PACK, ROWS, RHS,Ni, . . . ,Nm, 

This  agendum  processes  a binary  A-tape  and  the  current  H-region 
in  core  to  a BCD  tape  in  LP/90  input  format.  The  parameters  REWIND, PACK, ROWS 
may  be  omitted  or  placed  in  any  order.  If  used,  the  parameter  RHS  must 
be  last. 


Nomenclature 


cu  = tape  unit  for  output,  if  omitted  B2  is  used 

REWIND  = write  EOF  and  rewind  output  tape  at  conclusion 

PACK  = pack  output  (approx.  33  lines/record)  (suitable  for 
printing  only) 

ROWS  = output  ROW  id's  and  BASIS  only 

RHS  = output  RHS  (which  can  be  specified  by  number  in 

trailing  parameters)  only. 

No  options  result  in  unpacked  ROW  ID,  BASIS,  MATRIX, RHS. 


EXAMPLES  OUTPUT 


Agendum 

ROW  ID 

Matrix 

RHS  No's 

A.TO.IjCu 

yes 

yes 

all 

A.TO. I, cu, ROWS 

yes 

no 

no 

A.  TO. I, cu, ROWS, RHS 

yes 

no 

all 

A.TO. I, cu, ROWS, RHS, 1,7 

yes 

no 

1,7 

A. TO. I, cu, RHS 

no 

no 

all 

A.TO. I, cu, RHS, 1,7 

no 

no 

1,7 

output  tape  is  printed  it 

must  be  listed 

single 

space,  not  under 

program  control. 
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C ARD /TAPE, cu, LOW 

This  agendum  routine  reads  all  cards  following  in  the  card- 
reader,  converts  them  to  BCD  and  writes  them  on  the  tape  designated 
as  cu  (c  ® channel,  u = unit)  in  high  density  (unless  ,LOW  is  punched) 
until  a card  punched  END***  in  colso  1-6  is  encountered o When  the 
END***  card  is  read  an  end-of- file-mark  is  put  on  the  tape  and  the 
tape  is  rewoundo  The  card  following  may  be  another  agendumo 

The  routine  is  mostly  a convenience  routine  to  allow  loading 
small  problems  on-line  if  the  1401  or  other  card  to  tape  equipment  is 
not  availabloo  However,  it  may  also  be  used  for  loading  small  I-tapes 
for  use  by  REVISE » 


COMPILE , cu , cu , N , REWIND 

This  agendum  compiles  a report  writing  program  labelled  with 
the  integer  No  The  compiled  report  can  be  called  for  by  number  by 
using  the  Agendum  REPORT.  The  compile  data  cards  are  read  from  the 
unit  designated  by  the  first  cu,  (c  = channel,  u = unit)  which  may  be 
the  card  reader.  The  report  program  is  written  on  the  second  designated 
unit  (which  must  be  a tape  unit) . The  COMPILE  agendum  destroys  the 
initial  conditions  in  core»  Therefore,  it  must  be  followed  by  INPUT, 
RESTART,  etc,  prior  to  using  other  agenda. 

The  compile  data  card  format  description  and  the  Input  Card 
Form  are  given  on  succeeding  pages. 

The  report  is  labelled  1 if  the  parameter  N is  missing  or  zero. 
The  final  punching  REWIND  causes  the  input  tape  to  be  rewound  after 
it  is  processed.  If  this  parameter  is  left  blank  the  tape  is  in 
position  to  read  the  record  following  END***  and  thus  is  ready  to  do 
INPUT,  another  report,  etc. 


See  REPORT  below 
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Col. 

Coi. 


Col. 

Col. 

Col. 

Col. 


Cul. 


Col. 


C(^IPILE  CARD  FORMAT 


1 Printer  Control 

1 = New  Page  b = Single  Space  (b  = blank) 

0 = Double  Space  + = No  Space  • 

2 Card  Type 

H = Hollerith  text,  col.  3-72  are  in  print  line. 

C = Continuation  card,  limited  to  one  continuation  card  if 

Hollerith  text  in  which  case  col.  13-60  continues  the  text. 
T ^ Title;  begin  new  page,  problem  heading  and  page  number  on 
first  line. 

3 Blank 


4  Z = Suppress  line  if  all  computed  values  are  zero.  Should  be 
used  only  on  the  first  card  calling  for  computation  in  a 
line. 

icieii 

1-6  END  terminates  loading  of  Compile  Cards. 


5-9  Format 

Col.  5-9  blank  means  do  not  print. 

Col.  5-7  decimal  point  position  in  print  line. 

Col.  8 decimal  point  or  comma.  If  comma,  commas  will  be 
inserted  to  mark  the  thousands  place  in  values. 


Col.  9 positions  to  the  right  of  decimal  point.  (If  0, 
the  decimal  is  suppressed.) 


10-15  New  Variable  Name 

Any  alphanumeric  s^/mbol  allowed,  up  to  6 characters.  The  symbol 
is  used  as  in  Fortran,  e.g.,  XI  = C 5.  followed  by  XI  = C 17. 
is  legal,  X will  have  the  value  5 between  the  first  and  second 
defining  statements. 

16,  25,  etc.  Operator 

+ = add  / = divide 

- = subtract  = ~ equals  (may  be  used  in  col,  16  only) 

* = multiply  S — Scale  all  variables  of  kind  indicated  in 

type  field.  The  scale  factor  is  written 

in  Constant  format  in  the  name  field 
following  the  op.  More  than  one  scale 
can  be  given  on  one  card.  It  must  be 
the  very  first  card  of  deck  if  used. 
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Col.  17,  26,  etc.  Operand  Type 

X = Beta  (Primal  Variable,  use  col.  name) 

P = Pi  (Dual  Variable,  use  row  name) 

B = Right-Hand  Side 

D = D/J  (will  be  computed  during  REPORT) 

A = a^"  from  matrix 
J 

C = Constant 

N = New  variable  previously  defined  in  column  10-15  (at  its 
current  value) 

M = Objective  function  values,  (From  Beta  region  identified  by 
TO'w  name.) 

Col,  18,  27,  etc.  Slack  type  for  indicating  slack  variables.  For  betas 
this  column  must  be  or  blank.  For  all  other  types  of 

operands  this  must  be  blank.  Exception;  Constant  values  must 
begin  in  this  column. 

Col.  19-24,  28-33,  etc.  Name  of  Operand;  if  this  is  a new  variable  it  must 
have  been  defined  sometime  previously  in  col,  10-15. 

Note  1:  Arithmetic  operatons  are  of  the  form; 

(((=X-)opX2)opX^)  where  quantities  on  left  are 
operated  on  by  '^the  next  succeeding  quantity  on  the 
right  and  are  thereby  redefined  for  the  next  succeeding 
operation. 

If  type  field  is  A,  then  the  corresponding  name  field 
is  the  column  name  and  the  next  contiguous  (cannot  be 
on  next  card)  name  field  is  the  row  name  defining  the 
element. 


Note  2: 
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CORRECT ,BCD,cu,cu,cu,n,J,Y, REWIND , LOW ,G ENERAL 


This  agendum  corrects  a BCD  tape  by  inserting,  deleting,  or 
changing  any  number  of  records.  The  last  record  must  be  an  EOF  card 
unless  the  punching  , GENERAL  is  included  on  the  agendum  card. 

While  this  program  was  written  primarily  to  correct  LP/90  input 
tapes  (with  EOF  cards)  any  BCD  tape  may  be  corrected  by  operating  in 
the  GENERAL  mode.  To  obtain  maximum  speed  extensive  buffering  has 
been  used;  however,  this  requires  either  EOF  cards  or  that  the  last 
record  to  be  written  on  the  new  tape  be  part  of  the  data  input. 


Nomenclature 

The  first  cu  gives  the  old  I-tape.  The  second  cu  gives  the  new 
I-tape  and  the  third  cu  gives  the  unit  on  which  the  correction  records 
are  to  be  found.  Only  the  latter  may  be  the  card  reader  (CR) . As 
usual,  c designates  the  channel  and  u designates  the  unit. 


n 


J 


L 


number  of  EOF  cards  (jobs)  to  be  read  and 
copied  prior  to  tape  correction, 

total  number  of  jobs  (EOF  cards)  to  be  output. 
This  includes  both  the  jobs  to  be  corrected 
and  those  only  to  be  copied.  The  number  of 
jobs  on  I-tape  could  be  greater  than  the 
specified  J.  Unless  specified,  J is  assumed 
to  be  1, 

word  length  of  records  output,  if  not  specified, 
it  is  set  to  14  words. 


REV7IND  or  0 = The  former  causes  rewinding  of  all  tapers;  the 

Input  tape  is  also  unloaded.  The  punching  "0” 
will  inhibit  rewinding  all  tapes. 

r 

4 

LOW  or  0 = The  density  of  the  output  tape  is  set  to  high 

unless  LOW  is  specifically  requested. 


GENERAL  causes  program  to  operate  in  the  GENERAL  mode.  Zero  or  blank 
orient  the  program  to  LP/90  for  counting  of  EOF  cards. 
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Control  Cards  Used  by  CORRECT. BCD 

The  correction  unit  may  contain  10  types  of  control  cards  in 
addition  to  the  data  cards  that  are  to  be  written  on  the  output  tape. 
These  are  briefly  described  below.  The  control  card  names  are  punched 
beginning  in  card  column  one.  A control  card  without  a name  is  a 
‘‘comparison  card." 

MATCH, B,E  - Compare  cols.  B through  E inclusive  on  the  following 


"comparison"  card  with  the  same  column  fields  on  I-tape. 

Do  not  compare  any  columns  outside  of  this  field.  This 
range  of  columns  remains  effective  until  another  MATCH 
card  is  encountered.  Any  number  of  contiguous  columns  on 
a card  may  be  used  for  the  comparison  field.  Neither  B 
nor  E may  be  greater  than  72  if  the  correction  unit  is  the 
card  reader. 

After  a "comparison  card"  is  read  the  input  tape  is  copied 
onto  the  output  tape  until  a matching  record  is  found  on 
input.  (See  MATCH, B,E  below.)  The  correction  unit  is  then 
read  for  the  next  control  card. 

INSERT, N 

- Insert  the  next  N cards  that  follow  the  INSERT  card  after 
the  matched  record. 

DELETE, N 

- Delete  N records  beginning  with  the  matched  record. 

CHANGE ,N 

- Replace  the  N records  beginnins  with  the  matched  record 
with  the  N cards  following  the  CHANGE  card.  CHANGE,©  is 
legal;  it  is  used  in  the  GENERAL  mode. 

$$$$$$ 

- This  card  may  be  used  instead  of  a comparison  card.  No 
match  is  performed;  the  next  instruction  card  is  read 
immediately.  This  permits  multiple  operations  at  one  point. 

ADDROW 

- (For  LP/90  only)  This  causes  the  program  to  insert  all  the 
following  matrix  element  cards  (no  other  cards  are  permitted) 
into  the  correct  vectors  on  the  input  tape.  Only  additions 
to  previously  existing  vectors  or  RHS*s  may  be  made.  Once 
an  ADDROl-J  card  is  found,  no  other  control  card  is  permitted 
except  END***, 

CHGROW 

- (For  LP/90  only)  Is  similar  to  ADDROW;  it  is  used  to 
replace  existing  matrix  elements  instead  of  adding 
elements.  Once  a CHJROW  card  is  found,  no  other  control 
card  is  permitted  except  END***, 
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UNTIL, N - This  operation  is  used  only  in  the  GENERAL  mode;  it  defines 
the  end  card.  All  columns  of  the  card  immediately  following 
the  UNTIL  card  are  matched  against  the  input  records.  The 
tape  is  copied  (no  further  corrections  are  allowed)  until 
N of  the  cards  are  found.  After  copying  the  last  card  that 
was  found,  the  program  terminates, 

END***  - This  card  must  always  be  the  last  card  in  the  correction 
unit.  This  is  not  used  in  the  GENERAL  mode. 

Record  length  on  all  tapes  must  be  no  greater  than  14  words. 

Input  and  Output  tapes  should  be  on  different  channels  for 
greatest  speed. 


DIFFERENCE, B1,B2,K 

Many  times  the  path  from  an  optimal  solution  with  one  right- 
hand-side  to  an  optimal  solution  with  a different  right-hand- side  is 
shortened  by  using  PLP  than  by  using  NORMAL.  However,  for  right-hand- 
sides  with  many  elements  it  may  be  impractical  to  pre-punch  the  change 
vectors.  DIFFERENCE  is  designed  to  overcome  this  difficulty. 

DIFFERENCE  will  subtract  the  right-hand- side  numbered  B2  from 
right-hand-side  numbered  Bl;  the  difference  will  be  written  on  the 
A-tape  as  right-hand- side  number  K. 

Illustration  of  how  to  use  a DIFFERENCE  follow: 

DIFFERENCE, 2, 1,3 
NORMAL, 0,1 
SET  THETA 
D0oPLP,3,1.0 
SET  THETA 
NORMAL, 0,2 

ETC. 

NORMAL, 0,1 
DIFFERENCE, 2, 1,3 
SET  THETA 
D0oPLP,3,1.0 
SET  THETA 
NORMAL, 0,2 


ETC 
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EPSILON, 

This  routine  generates  two  new  RHS's  numbered  and  and 
places  them  on  the  A-tapeo  RHS  equals  the  existing  RHS  B plus  a 
constant  E in  all  less  than  or  equal  and  equality  rows  and  minus  the 
constant  E in  all  greater  than  or  equal  rows  for  which  the  corresponding 
element  of  RHS  B is  zero.  The  RHS  equals  the  RHS  B minus  the  newly 
created  RHS  E is  a positive  decimal  fraction  and  must  contain 

a decimal  point. 

This  routine  is  useful  for  problems  that  have  right-hand- 
sides  with  a high  percentage  of  zero  elements.  Better  results  can 
usually  be  obtained  by  using  RHS  in  NORMAL  and  then  DO.PLP  with 
the  change  vector  K^o 

EXTSOLjK 

Each  vector  of  the  constraint  matrix  (including  slacks)  in 
the  current  basis  is  multiplied  by  the  corresponding  element  of  the 
BETA  vector  (primal  variables).  The  results  are  written  in  TABLEAU 
format.  If  the  flag  *’K"  is  punched  only  those  vectors  given  on  the 
following  cards  in  INTRODUCE  format  are  used.  (See  INTRODUCE  Section  1 
of  this  part.) 

FLAGS, mode, space 

FLAGS,  is  an  LP/90  agendum  routine  which  may  be  used  to 
suppress  certain  matrix  columns  from  the  solution.  The  use  is  similar 
to  that  of  partitions  except  that  (1)  the  suppressed  columns  need  not 
be  contiguous,  and  (2)  any  flagged  column  is  removed  from  the  basis  even 
if  it  is  in  the  initial  basic  solution.  The  original  A-tape  is  re- 
written using  the  U-tape  as  an  intermediate  scratch  tape.  If  a 
column  is  removed  from  the  basis,  INVERT  is  automatically  called  at 
the  end  of  the  routine. 
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This  agendum  may  also  be  used  to  remove  the  suppression  bits 
from  specified  columns  making  them  available  to  enter  the  solution o 


Nomenclature 


mode  = IGNORE  if  columns  are  to  be  suppressed,  (that  is 

removed  from  and  prevented  from  entering  the  solution) • 

= RESTORE  if  columns  are  to  be  restored;  that  is,  the 
IGNORE  bit  is  removed.  If  all  columns  are  to  be 
restored,  the  parameter  "specs”  may  be  omitted, 

specs  s NAMESb  — the  following  cards  will  contain  the  names 

of  variables  (columns)  that  are  to  be  flagged.  Column 
names  are  punched  up  to  11  per  card  in  successive 
fields  of  6 col.,  beginning  in  col.  7.  Blank  fields 
are  skipped.  The  last  name  must  be  followed  by  END*** 
in  the  next  field.  Col.  1-6  must  be  blank. 

= MASK, b 

the  six  characters  after  the  comma  are  a **mask”  and 
correspond  by  position  to  the  characters  of  the  column 
names  and  may  contain  zeros  or  asterisks.  A zero 
indicates  that  the  character  is  not  to  be  considered 
in  the  class  definition,  an  asterisk  indicates  that 
it  will  be  considered.  The  following  cards  define, 
starting  in  col,  7,  successive  six  character  fields 
containing  any  member  of  the  class  to  be  flagged,  Tne 
last  class  must  be  followed  by  END***. 

= CLASS, F,L  An  alternate  way  of  specifying  classes  of 
vectors.  (See  Cost  Ranging  description.)  It  is 
recommended  that  MASK  be  used  instead. 

= FROMjXXXXXX  All  vectors  beginning  with  the  vector 
named  JCXXXXX  through  the  end  of  the  matrix  will  be 
flagged. 

= THRUjXXXXXX  All  vectors  from  the  beginning  of  the 
matrix  through  vector  XXXXXX  will  be  flagged. 

= FROM,XXXXXX,THRU,YYYYYY  All  vectors  beginning  with 
vectoi  XXXxibc  through  vector  YYYYYY  will  be  flagged. 
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EXAMPLES ; 

Card  1 FLAGS , IGNORE ,NAMES 


Card  2 


Card  1 
Card  2 


Card  1 


12345A22345AEND*** 

This  will  cause  the  vectors  named  12345  ahd  22345A 
to  be  ignored. 

FLAGS , IGNORE ,MASK,*000 

12345A22345AEND*** 

This  will  cause  all  vectors  that  have  a 1 or  a 2 in 
the  first  column  of  their  names  and  an  A in  the 
sixth  column  of  their  names  to  be  ignored. 

FLAGS, RESTORE, FROM, 12345A, THRU, 22345A 

All  activities  physically  between  vectors  12345A 
and  22345A  inclusive  will  be  restored  to  the  matrix. 


Restriction:  The  U-tape  must  be  available, 

NOTE:  Flags  comes  back  to  the  system  "clean."  That  is, 

an  inversion  is  done  if  needed  before  control  is 
relinquished  to  the  system. 


PICTURE  or  PICTURE, HELP 

The  two  forms  of  PICTURE  are  used  under  different  conditio  -j. 

The  first  condition  is 

PICTURE  This  may  be  used  after  INPUT  or  between  any  two  agenda 

for  the  purpose  of  translating  the  A-tape  into  pictorial 
form  on  the  0-tape.  All  numbers  other  than  1 are  con- 
verted to  alphabetic  symbols  which  indicate  magnitude. 

The  first  page  of  output  defines  these  symbols.  Fifty- 
five  vectors  and  sixty  lines  are  output  for  each  page  ai;id 
the  pages  are  numbered  in  matrix  notation  for  easy 
identification. 

The  program  is  effective  in  showing  the  analysit  the 
structure  of  his  matrix  and  may  help  pick  out  incorrectly 
placed  or  missing  coefficients. 

PICTURE, HELP  ...  This  program  should  be  used  only  when  a "NO  FEASIBLE 
SOLUTION"  is  reached  in  NORMAL.  The  effect  of  the 
punching  ,HELP  is  to  extract  that  sub- set  of  vectors  in 
the  matrix  that  have  a first  order  interaction  with  the 
infeasible  conditions.  The  method  of  extraction  is  as 
follows : 
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1)  For  non- zero  artificials  - all  vectors  that  have 
non-zero  coefficients  in  the  row  positions  corresponding 
to  the  artificial  positions  will  be  extracted. 

2)  For  negative  activities  - all  vectors  having  coefficients 
in  the  same  row  positions  as  non-zero  elements  in  vectors 
with  negative  values  will  be  extracted. 

For  the  ,HELP  portion  of  picture  the  U-tape  must  be  avail- 
able to  the  program. 

The  output  is  made  directly  to  the  0-tape,  bypassing  the 
mediary  tape.  Therefore  PICTURE  output  will,  in  general, 
be  the  first  item  on  the  0-tape,  and  will  be  followed  by 
the  contents  of  the  M-tape  translated  by  OUTPUT. 


REPORT, cu,N 


This  agendum  calls  in  the  report  writing  program  (identified  by 
N and  previously  prepared  by  COMPILE)  from  tape  unit,  cu.  It  may  be 
used  after  NORMAL,  DO.PLP,  and  DO.PCR  to  prepare  a formal  report. 

If  blank  or  zero,  N is  set  to  1.  The  machine  contents  are  saved  on 
U-tape  when  REPORT  is  called  in  and  restored  before  going  to  the  next 
agendum,  V-tape  is  used  for  scratch,  and  the  output  is  written  directly 
on  0-tape.  A typical  agendum  sequence  might  be: 


HEADING  USE  COMPILE- STACK  REPORT 

C0MPILE,B1,B5,1 

C0MPILE,B1,A2,2 

STACK, REPORT ,A2,B5 

INPUT, 1 

NORMAL, 1,1 

REPORT, B5,l 

DO.D/J 

NORMAL, 1,2 

REPORT, B5, 2 

PUNCH 

OUTPUT 

If  used  after  DO.PLP  or  DO.PCR  only  the  final  iteration  will 

be  reported. 
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SENS IT  or  SENS IT ,K 

SENSIT  is  designed  to  give  the  rate  of  change  in  the  objective 
function  for  a small  change  in  the  non-zero  coefficient  of  the  optimal 
basis.  That  is, 

^jt/3a..  for  all  a.,  o in  the  optimal  basis. 

3.J 

The  output  is  in  TABLEAU  form  for  easy  identification  of  the 
elements.  Activities  with  zero  values  are  not  output. 

If  all  vectors  of  the  basis  are  desired  the  agendum  card  is 
punched  SENSITb.  If  the  flag  "K’’  is  punched  only  those  vectors  given 
on  the  following  cards  (in  INTRODUCE  format)  are  used. 


STACK , REPORT , cu , cu 

This  agendum  will  stack  compiled  report  v/riting  programs  on  a 
single  tape  for  later  use  by  the  REPORT  agen4um.  The  order  of  units 
is  channel  and  unit  of  report  to  be  added,  then  channel  and  unit  of 
stack  tape.  The  punching  ", REPORT,*’  is  required.  The  number  of  the 
incoming  report  to  be  added  is  checked  against  the  existing  reports  on 
the  stack  tape  and  renumbered  if  necessary.  Thus,  there  must  already 
exist  at  least  one  report  on  the  stack  tape  prior  to  using  this  agendum. 


TITLE 


The  information  in  columns  13-72  of  the  agendum  replaces  the 
page  heading  on  all  subsequent  printout.  It  is  used  in  preference  to 
HEADING  when  it  is  desired  not  to  reset  the  control  paramters  to  ^ 
their  programmed  values. 
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3.  USDA  AGENDA 

CREATE,C,K 

The  purpose  of  this  agendum  is  to  create  a new  right-hand- side 
on  the  LP  A-tapeo  It  does  this  by  multiplying  the  current  solution 
in  core  by  a "change  matrix”  in  A-tape  format  (but  called  the  C-tape) 
and  adding  a dummy  right-hand-side  vector  on  the  change  matrix  tape 
(C-tape) o The  new  right-hand- side  is  given  the  index  C and  stored  on 
the  A-tapeo  Thus,  we  have 

* 

C ^ X + ka 

where  c is  the  new  RHS  on  the  A-tape;  $ is  the  change  matrix  on  the 
C-tape,  k is  the  dummy  RHS  or  "exogenous"  vector  on  the  C-tape,  and 

•k 

where  x is  the  solution  vector  in  core  (excluding  slacks).  CREATE, C,K 
is  used  after  a NORMAL.  The  indexes  C and  K must  be  greater  than  0 and 
less  than  1000. 

CREATE ,C , K, INITIATE 

This  routine  functions  exactly  like  CREATE, C,K  except  that  it 
assumes  that  the  primal  solution  in  core  was  put  there  by  GAMMAB,cu, INITIATE. 
Therefore  it  should  be  used  after  the  latter  agendum.  See  below. 

GAMMABjCu 

This  agendum  creates  a change  matrix  in  A-tape  format  (but 
puts  it  on  the  C-tape  for  use  by  the  Agendum  CREATE.  It  does  this  in 
effect  by  multiplying  a diagonal  matrix,  say  times  the  LP  constraint 
matrix  (not  including  slack  vectors).  Thus  if  0 is  the  change  matrix 
and  B the  constraint  matrix  then  $ = tb. 

The  diagonal  elements  of  ^ are  read  into  core  from  the  input 
unit  specified  on  the  agendum  card  (c  = channel,  u = tape  number, 

CR  = card  reader) . The  B portion  of  the  LP  matrix  is  obtained  from 
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the  A-tape  created  by  a previous  INPUT, TRANSFORM  etc.  The  new  matrix 
is  placed  on  the  C-tape.  If  any  exogenous  vectors  are  desired  on  the 
C-tape  they  must  already  be  on  it.  The  C-tape  must  be  in  A-tape 
format  and  must  contain  all  announcement  records  as  required  by  INl^UT 
(ROW  ID,  MATRIX,  FIRST  B,  etc.,  END)  even  though  there  are  no  matrix 
elements . 

The  diagonal  elements  of  T have  the  same  format  as  the  RHS 
elements,  and  the  row  names  must  correspond  to  the  active  constraint 
row  names  on  the  A-tape.  Only  non-zero  elements  need  be  input. 

Reading  is  terminated  by  a card  with  EOF  in  columns  1-3. 

See  READ, CHANGE  M/\TRIX  below. 

GAMMAB  ,cu , INITIATE 

This  agendum  is  used  to  read  in  an  initial  solution  vector  in 
core  for  use  by  CRE.ATE,C,K, INITIATE.  The  element  cards  are  now 
process  levels  (primal  variables  or  BETA  values)  and  are  punched  the 
same  as  the  P-elements  in  GAMMAB, cu  except  that  the  column  names  are 
punched  in  card  columns  7-12,  Only  non-zero  process  levels  are  input. 


INPUT,q,n,  A. , , , A,MATRIXG 

The  input  for  this  Agendum  is  a basic  data  matrix  in  I-tape 
format  called  the  "G"  Matrix,  It  is  used  by  TRANSFORM,  The  para- 
meters "q**  and  ”n'*  have  the  same  meaning  as  in  INPUT,  The  word 
”A,  ,.,A"  may  be  REWIND,  COUNTS,  OR  PUNCH  with  the  same  meaning  as 
in  the  SHARE  INPUT  Agendum,  See  TRANSFORM  for  usage. 

INPUT , q , n , A, , . , A, MATRIXT 

This  Agendxim  is  the  same  as  INPUT,  but  is  used  to  input  the 
"T”  Matrix  for  use  by  the  Agendum  TRANSFORM,  The  T Matrix  is  in 
I-tape  format.  All  parameters  are  the  same  as  in  the  SHARE  INPUT 
Agendum,  See  TRANSFORM  for  usage. 
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READ,  CHANGE  MATRIX, Q ,N, COUNTS 

This  routine  is  used  to  read  the  change  matrix  and  exogenous 
vectors  from  the  I-tape  and  convert  them  to  binary  on  the  C-tape.  The 
input  tape  format  is  exactly  the  same  as  that  used  by  INPUT.  The  rows 
and  columns  of  the  change  matrix  must  have  exactly  the  same  names  as  the 
LP-matrix  on  the  I-tape.  Hence,  the  ROW  ID  list  must  be  the  same  for 
INPUT,  and  READ, CHANGE  MATRIX.  Sometimes  the  user  may  desire  to  read- 
in  the  exogenous  vectors  only  with  this  routine  and  compute  the  change 
matrix  with  GAMMAB,  In  this  case  a dummy  change  matrix  must  be  read 
in.  This  may  consist  of  only  one  vector  element  which  is  located  in  a 
constraint  row.  The  parameters  Q,N,  etc.,  have  the  same  meaning  as  INPUT. 


TRANSFORM, cu 

This  routine  creates  an  LP/90  matrix  from  a basic  data  matrix 
and  a second  transforming  matrix;  or,  it  may  be  used  to  modify  an 
existing  LP/90  matrix  by  means  of  matrix  multiplication. 

If  we  let  G be  the  basic  data  or  original  LP/90  matrix  and  T 
the  tranforming  matrix,  the  TRANSFORM  performs  the  operation  H = TG. 
The  matrix  H is  in  binary  on  the  A-tape  at  the  termination  of  this 
agendum  and  is  ready  for  use  by  NORMAL  etc. 

Examp le  1 Let  P be  a price  matrix,  A a flow  coefficient  matrix, 

B a stock  coefficient  matrix,  I an  identity  matrix, 
then  TRANSFORM  performs  the  following: 


0 

A 

z 

I 

0 

B 

= 

A 

-I 

0 

-A 

' 0 

I 

B 

This  operation  creates  a set  of  objective  function  Z,  a double  set  of 
change  rows  for  a complete  PCR,  A and  -A,  and  carries  over  the  active 
constraint  rows. 
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Example  2 


0 P 0 

z 

z* 

0 10 

A 

= 

A 

0 0 1 

_B  _ 

This  operation  replaces  the  old  set  of  objective  functions  with  a new 
set . 


This  agendum  routine  is  called  by  a card  punched  as  follows, 


starting  in  column  1. 


TRANSFORM, cu 


Just  prior  to  reading  this  card  the  following  conditions  must 


exist: 


(1)  The  G matrix  must  be  on  a "GETOFF”  tape  on  channel  c, 
tape  unit  u. 

(2)  The  T matrix  must  be  on  the  ATAPE  with  matrix  parameters 
set  in  the  Communications  Region. 


The  G matrix  must  be  input  with  the  following  card 
(Punching  begins  in  column  1): 


INPUT , q , n , REWIIT) , MATRIXG , or 
INPUT , q , n , COUNTS , MATRIXG , or 
INPUT , q , n , PUNCH , MATRIXG , 

where  the  parameters  q and  n have  the  same  meaning  as  in  INPUT,  and 
similarly  for  the  options  RE WIND, COUNTS  and  PUNCH.  The  parameter  p 
must  be  greater  than  or  equal  to  the  total  number  of  rows  in  the  G 
matrix  or  less  than  or  equal  to  1024. 

The  value  p is  used  in  calculating  the  size  of  the  G matrix 
records.  The  smaller  the  p the  larger  the  records.  A small  value 
is  desirable. 

The  T matrix  must  be  input  with  the  following  card: 


INPUT , q , n , REWIND , MATRIXT 
INPUT , q , n , COUNTS , MATRIXT 
INPUT , q , n , PUNCH , MATRIXT . 

The  ROW  ID  list  of  matrix  T is  used  for  matrix  H.  H slacks 
also  are  generated  in  accordance  with  this  list.  All  H right-hand- 
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sides  must  be  input  with  matrix  T.  All  vectors  flagged  in  the  G matrix 
will  be  flagged  in  the  H matrix.  (See  FLAGS). 

The  vectors  of  T must  match  the  rows  of  G both  in  name  and  order. 

Any  curtains  or  partitions  found  in  either  matrix  T or  G are  ignored; 
they  are  not  put  in  matrix  H.  Any  H vector  with  all  zeros  in  the 
constraint  rows  will  be  deleted.  All  right-hand- sides  for  the  H 
matrix  must  be  input  with  the  T matrix.  An  initial,  all-slack  basis 
exists  at  the  completion  of  TRANSFORM. 

An  example  of  deck  arrangement  is: 

HEADING  DECK  SETUP 

INPUT, 1, , COUNTS, MATRIXG, 350 
GET0FF,B6 

INPUT, 5, , COUNTS,  REWIND ,MATRIXT  t 

TRANSFORM, B 6 
NORMAL, 4, 3 
OUTPUT 

The  B6  tape  could  be  saved  and  used  as  long  as  matrix  T had  350 
rows  or  less. 
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